Canvas Lms MCP Local
Student-focused Canvas LMS tools for grades, deadlines, submissions and study plans
- Pricing
- Open source
- Platforms
- CLI, Windows, macOS
- Runs
- Locally
- Version
- 1.4.0
- Listing updated
- 3 days ago
About Canvas Lms MCP Local
Canvas Lms MCP Local is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
This is the Local Edition of a Canvas LMS server: your AI app starts it as a child process and talks to it over a private pipe, so nothing listens on the network and no tunnel is needed. It authenticates with a Canvas personal access token and your school's Canvas address, and a companion Remote Edition with the same tools exists for use across devices.
It leans toward questions students actually ask rather than raw API calls. Grade tools cover what-if scenarios, the score needed for each letter grade with group weights, and a ranking of which assignments matter most. Planning tools build a daily briefing, a week-ahead view and a study plan that fits blocks before each deadline around your calendar and can add them to Canvas. Assignment briefs gather instructions, rubric, late policy and linked files in one call, and lecture PDFs, Word docs and slides can be read in-chat.
Submissions, discussion posts and messages go through a preview first and nothing is sent until confirmed. A CANVAS_PROFILE setting turns on subsets of tools, from essentials to read-only, which helps limit what an assistant can do. It needs Node.js 18 or newer (22 or newer to read PDFs), and Windows users can use a guided installer app.
Install
Run in a terminal
claude mcp add canvas-lms-mcp-local --env CANVAS_API_TOKEN='<CANVAS_API_TOKEN>' --env CANVAS_BASE_URL='<CANVAS_BASE_URL>' -- npx -y canvas-lms-mcp-localAdd to claude_desktop_config.json
{
"mcpServers": {
"canvas-lms-mcp-local": {
"command": "npx",
"args": [
"-y",
"canvas-lms-mcp-local"
],
"env": {
"CANVAS_API_TOKEN": "<CANVAS_API_TOKEN>",
"CANVAS_BASE_URL": "<CANVAS_BASE_URL>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"canvas-lms-mcp-local": {
"command": "npx",
"args": [
"-y",
"canvas-lms-mcp-local"
],
"env": {
"CANVAS_API_TOKEN": "<CANVAS_API_TOKEN>",
"CANVAS_BASE_URL": "<CANVAS_BASE_URL>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"canvas-lms-mcp-local": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"canvas-lms-mcp-local"
],
"env": {
"CANVAS_API_TOKEN": "<CANVAS_API_TOKEN>",
"CANVAS_BASE_URL": "<CANVAS_BASE_URL>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"canvas-lms-mcp-local": {
"command": "npx",
"args": [
"-y",
"canvas-lms-mcp-local"
],
"env": {
"CANVAS_API_TOKEN": "<CANVAS_API_TOKEN>",
"CANVAS_BASE_URL": "<CANVAS_BASE_URL>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"canvas-lms-mcp-local": {
"command": "npx",
"args": [
"-y",
"canvas-lms-mcp-local"
],
"env": {
"CANVAS_API_TOKEN": "<CANVAS_API_TOKEN>",
"CANVAS_BASE_URL": "<CANVAS_BASE_URL>"
}
}
}
}Configuration
CANVAS_API_TOKENCanvas personal access token (Account > Settings > Approved Integrations > New Access Token)RequiredCANVAS_BASE_URLYour school's Canvas address, e.g. https://yourschool.instructure.comRequiredCANVAS_PROFILEOptional. Which tools to turn on, by name or number: 1 essentials, 2 core, 3 study, 4 grades, 5 readonly, 6 full. Not set means full, every tool
Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- test_connection
- Checks the connection to your Canvas account.
- daily_briefing
- Summarises today's classes, what is due, new grades and unread announcements.
- get_week_ahead
- Shows the week-ahead view of deadlines.
- semester_snapshot
- Gives an overview of the semester across courses.
- study_plan
- Spreads study time before each deadline around your calendar.
- schedule_study_plan
- Puts the study plan on your Canvas calendar.
- final_grade_scenarios
- Shows what you need for each letter grade, with group weights.
- what_if_grade
- Calculates a what-if grade.
- grade_impact_ranking
- Ranks which assignments affect the grade most.
- calculate_gpa
- Calculates GPA.
- assignment_brief
- Returns instructions, rubric, late policy and linked files for an assignment.
- read_course_file
- Reads lecture PDFs, Word documents and slides.
What it does
- Grade scenarios
- Calculates what-if grades and the score needed for each letter grade.
- Daily and weekly views
- Gives a daily briefing, week-ahead view and semester snapshot.
- Study planning
- Fits study blocks before deadlines and can schedule them in Canvas.
- Assignment briefs
- Collects instructions, rubric, late policy and files in one call.
- Confirmed submissions
- Previews text, link and file submissions before anything is sent.
- Course file reading
- Reads lecture PDFs, Word documents and slides.
- Tool profiles
- Lets you enable essentials, study, grades, read-only or full toolsets.
Good for
- Work out what score is needed on the final for a target grade
- See every missing assignment across all courses in one answer
- Plan study time around deadlines and a personal calendar
- Draft and submit an essay after previewing it
- Summarise a discussion thread before replying
Pricing
Open source
Free; requires your own Canvas token
Prices change. Check fireiscoolsolo.github.io before you buy.
Canvas Lms MCP Local FAQ
What do I need to set it up?
A Canvas personal access token, your school's Canvas URL and Node.js 18 or newer.
Is anything exposed to the internet?
No. The server runs locally over a private pipe and opens no port.
Can it submit work without asking?
No. Submissions, posts and messages go through a preview and wait for confirmation.
Can I limit which tools are on?
Yes, CANVAS_PROFILE selects essentials, core, study, grades, read-only or full.
What is the Remote Edition?
A separate server with the same tools reachable from web and mobile apps via a password-protected tunnel.
Is Canvas Lms MCP Local free?
Yes. Canvas Lms MCP Local is open source, so you can use and self-host it for free.
How do I add Canvas Lms MCP Local to Claude Code?
Run this command in your terminal: claude mcp add canvas-lms-mcp-local --env CANVAS_API_TOKEN='<CANVAS_API_TOKEN>' --env CANVAS_BASE_URL='<CANVAS_BASE_URL>' -- npx -y canvas-lms-mcp-local
What are the best alternatives to Canvas Lms MCP Local?
The closest alternatives to Canvas Lms MCP Local are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.
Alternatives to Canvas Lms MCP Local

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media