Prepare the server locally
Run this once before adding it to Claude Code.
bun install
bun run generate-keyRegister it in Claude Code
claude mcp add --transport http -H "Authorization: Bearer YOUR_MCP_TOKEN_HERE" canvas-mcp-30af https://canvas.dunkirk.sh/mcpReplace any placeholder paths in the command with the real path on your machine.
ENCRYPTION_KEYMake your agent remember this setup
canvas-mcp-30af's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- List Canvas courses with enrollment filtering
- Search for assignments across multiple courses
- Retrieve detailed assignment information
- Secure multi-institution support
- Encrypted token storage using AES-256-GCM
Tools 3
list_coursesList Canvas courses with enrollment filteringsearch_assignmentsSearch assignments across coursesget_assignmentGet detailed assignment informationEnvironment Variables
ENCRYPTION_KEYrequiredKey used for AES-256-GCM encryption of Canvas tokensTry it
Original README from taciturnaxolotl/canvas-mcp
Canvas MCP Server
This is a stream http transport Canvas LMS mcp server. A nice fancy bit of goblygook that just means its a remote integration you can plug into chatgpt, claude, poke, or anywhere else that supports mcp. If you want to try the hosted version its over at canvas.dunkirk.sh or feel free to self host!
Quick Start
# Install dependencies
bun install
# Generate encryption key
bun run generate-key
# Copy and configure environment
cp .env.example .env
# Add the generated encryption key to .env
# Run development server
bun dev
Visit http://localhost:3000 to connect your Canvas account.
MCP Tools
list_courses: List Canvas courses with enrollment filteringsearch_assignments: Search assignments across coursesget_assignment: Get detailed assignment information
Client Configuration
After connecting your Canvas account, add this to Claude Desktop config:
{
"mcpServers": {
"canvas": {
"url": "https://canvas.dunkirk.sh/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN_HERE"
}
}
}
}
Security
- Canvas tokens encrypted with AES-256-GCM before storage
- MCP tokens hashed with Argon2id (cannot be retrieved after creation)
- No Canvas tokens exposed to MCP clients
The canonical repo is hosted on tangled at `knot.dunkirk.sh/canvas-mcp`
<i><code>© 2026-present Kieran Klukas</code></i>