README.md
Connects Canvas LMS to AI assistants for course and assignment management.
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>
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 tokensConfiguration
claude_desktop_config.json
{"mcpServers": {"canvas": {"url": "https://canvas.dunkirk.sh/mcp", "headers": {"Authorization": "Bearer YOUR_MCP_TOKEN_HERE"}}}}Try it
→List all my current courses in Canvas.
→Search for assignments due this week across all my courses.
→Get the details for the final project assignment in my Data Science course.
→What assignments do I have pending in my History class?