Skip to content
MCP server

Canvas Lms MCP Local

Student-focused Canvas LMS tools for grades, deadlines, submissions and study plans

Runs locallyStatus and history
Install
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-local

Add 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)Required
  • CANVAS_BASE_URLYour school's Canvas address, e.g. https://yourschool.instructure.comRequired
  • CANVAS_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

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media