# Canvas Lms MCP Local

> Canvas Lms MCP Local is an open-source MCP server for productivity. Student-focused Canvas LMS tools for grades, deadlines, submissions and study plans. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux
- **Website:** https://fireiscoolsolo.github.io/canvas-lms-mcp-local/
- **Repository:** https://github.com/fireiscoolsolo/canvas-lms-mcp-local
- **MCP Registry name:** io.github.Fireiscoolsolo/canvas-lms-mcp-local
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/canvas-lms-mcp-local
