Skip to main content
Glama

Canvas MCP

Build TypeScript MCP License: MIT

A local MCP (Model Context Protocol) server for Canvas LMS. Query your courses, assignments, grades, modules, and more from any MCP-compatible AI client — Claude Desktop, Cursor, VS Code Copilot, and others.

Your API key stays on your machine. Unlike hosted MCP servers that require you to hand over your Canvas credentials, this server runs locally and communicates directly with your Canvas instance.

Architecture

graph TB
    subgraph "MCP Clients"
        Claude["Claude Desktop"]
        Cursor["Cursor / VS Code"]
        Other["Other MCP Clients"]
    end

    subgraph "Your Machine (Local)"
        Server["Canvas MCP Server<br/>Node.js + TypeScript"]
        ENV["Environment Variables<br/>CANVAS_API_KEY"]
    end

    subgraph "Canvas LMS Tools"
        Courses["list_courses"]
        Assignments["get_assignments<br/>get_upcoming_assignments"]
        Grades["get_grades<br/>get_submission_status"]
        Content["get_modules<br/>get_announcements<br/>get_discussions"]
        Calendar["get_calendar_events<br/>get_todo_items<br/>get_quizzes"]
        Profile["get_user_profile"]
    end

    subgraph "Canvas Instance"
        API["Canvas REST API<br/>HTTPS Only"]
    end

    Claude -->|stdio| Server
    Cursor -->|stdio| Server
    Other -->|stdio| Server

    ENV -.->|read at startup| Server

    Server --> Courses
    Server --> Assignments
    Server --> Grades
    Server --> Content
    Server --> Calendar
    Server --> Profile

    Courses --> API
    Assignments --> API
    Grades --> API
    Content --> API
    Calendar --> API
    Profile --> API

    style Server fill:#4CAF50,stroke:#333,color:#fff
    style ENV fill:#FF9800,stroke:#333,color:#fff
    style API fill:#2196F3,stroke:#333,color:#fff
    style Claude fill:#7C4DFF,stroke:#333,color:#fff
    style Cursor fill:#7C4DFF,stroke:#333,color:#fff
    style Other fill:#7C4DFF,stroke:#333,color:#fff

🔒 Privacy by design — your API key is read from local environment variables and sent only to your Canvas instance over HTTPS. No intermediary servers, no third-party storage.

Related MCP server: Canvas MCP Server

Features

  • 12 Canvas LMS tools — courses, assignments, grades, modules, quizzes, and more

  • Runs locally — your credentials never leave your machine

  • Zero config hosting — no servers, no Cloudflare, no Docker needed

  • Works with any MCP client — Claude Desktop, Cursor, VS Code Copilot, ChatGPT

  • TypeScript — fully typed with Zod validation

Quick Start

1. Get your Canvas API key

Go to Canvas → Account → Settings → Approved Integrations → New Access Token

📖 Never done this before? Follow the step-by-step guide with screenshots

2. Clone and build

git clone https://github.com/a-ariff/canvas-mcp.git
cd canvas-mcp
npm install
npm run build

3. Add to your MCP client

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "canvas": {
      "command": "node",
      "args": ["/path/to/canvas-mcp/dist/standalone.js"],
      "env": {
        "CANVAS_API_KEY": "your-canvas-api-token",
        "CANVAS_BASE_URL": "https://your-canvas-instance.edu"
      }
    }
  }
}

Add to your .cursor/mcp.json or VS Code MCP settings:

{
  "mcpServers": {
    "canvas": {
      "command": "node",
      "args": ["/path/to/canvas-mcp/dist/standalone.js"],
      "env": {
        "CANVAS_API_KEY": "your-canvas-api-token",
        "CANVAS_BASE_URL": "https://your-canvas-instance.edu"
      }
    }
  }
}

4. Start chatting

Ask your AI assistant things like:

  • "What courses am I enrolled in?"

  • "What assignments are due this week?"

  • "Show me my grades for Computer Science 101"

  • "Are there any new announcements?"

Tools

Tool

Description

Args

list_courses

Get all active courses

—

get_assignments

Get assignments for a course

course_id

get_upcoming_assignments

Upcoming assignments across all courses

—

get_grades

Grades and scores for a course

course_id

get_user_profile

Your Canvas profile info

—

get_modules

Course modules and structure

course_id

get_announcements

Recent course announcements

course_id

get_discussions

Discussion topics

course_id

get_calendar_events

Upcoming calendar events

—

get_todo_items

Pending action items

—

get_quizzes

Course quizzes

course_id

get_submission_status

Assignment submission status

course_id, assignment_id

Environment Variables

Variable

Required

Default

Description

CANVAS_API_KEY

Yes

—

Your Canvas API access token

CANVAS_BASE_URL

No

https://canvas.instructure.com

Your Canvas instance URL

DEBUG

No

false

Enable debug logging

Security

  • Local execution only — the server runs on your machine via stdio

  • Direct API calls — your Canvas API key is sent only to your Canvas instance, never to any third party

  • No data storage — nothing is cached or persisted between sessions

  • Environment-based config — credentials are read from environment variables, never hardcoded

Development

# install deps
npm install

# build
npm run build

# run locally
CANVAS_API_KEY=your-token CANVAS_BASE_URL=https://your-canvas.edu npm start

# run tests
npm test

# lint
npm run lint

Contributing

Contributions welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT

Available Tools

12 tools
get_announcementsC

Get recent announcements for a Canvas course

Inputs: course_id (required).

get_assignmentsC

Get assignments for a specific Canvas course

Inputs: course_id (required).

get_calendar_eventsB

Get calendar events for the authenticated user

Inputs: no named parameters.

get_discussionsB

Get discussion topics for a Canvas course

Inputs: course_id (required).

get_gradesB

Get current grades for a Canvas course, including assignment scores and overall grade

Inputs: course_id (required).

get_modulesC

Get all modules for a specific Canvas course

Inputs: course_id (required).

get_quizzesB

Get all quizzes for a specific Canvas course

Inputs: course_id (required).

get_submission_statusC

Check submission status for a specific assignment

Inputs: course_id (required), assignment_id (required).

get_todo_itemsA

Get todo items (assignments that need action) for the authenticated user

Inputs: no named parameters.

get_upcoming_assignmentsB

Get upcoming assignments across all courses with future due dates

Inputs: no named parameters.

get_user_profileA

Get the authenticated user's Canvas profile information

Inputs: no named parameters.

list_coursesA

Get all active Canvas courses for the authenticated user

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 12 tools

    Disambiguation4/5

    Each tool maps to a distinct Canvas resource (courses, assignments, grades, modules, announcements, discussions, calendar, todo, quizzes), but the assignment-related cluster (get_assignments, get_upcoming_assignments, get_todo_items, get_submission_status) has partial overlap that relies on descriptions to separate. The descriptions do a good job of clarifying scope (course-scoped vs cross-course vs action-needed vs status check), so misselection is unlikely but not impossible.

    Naming Consistency4/5

    Eleven of twelve tools use a clean get_<resource> pattern, which is highly predictable. The single list_courses breaks the pattern slightly, but it is idiomatic and readable.

    Tool Count5/5

    Twelve tools is squarely in the well-scoped range for a Canvas LMS surface. Each tool covers a distinct data type an agent would plausibly need, with no filler or redundant entries.

    Completeness3/5

    The surface is entirely read-only: there is no way to submit an assignment, post to a discussion, mark a todo complete, or fetch course files/pages/module items, which are core Canvas workflows. Reading grades, assignments, and announcements is covered, but the absence of any write operation and of content retrieval (files, pages, single-assignment detail) leaves notable gaps that will cause agent dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers