# Canvas Parent MCP

> Canvas Parent MCP is an open-source MCP server for education and exams. MCP server for parents and students to read Canvas LMS courses, grades and due work. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/chrischall/canvas-parent-mcp
- **MCP Registry name:** io.github.chrischall/canvas-parent-mcp
- **Categories:** [education and exams](https://ai-powered.com/categories/education-and-exams)
- **Listing updated:** 2026-11-18

## About

Scoped for parent observers and student self-access, this server reads a Canvas (Instructure) instance and defaults to cms.instructure.com, though any Canvas host works. It mirrors the read-only parent-portal scope of the author's infinitecampus-mcp.

It has 18 tools across profile, observees, courses, assignments, submissions, grades, calendar, planner, announcements, conversations, discussions and files. The planner tool takes a child by name, and a brief view returns one short line per item. Teacher-written HTML comes back as Markdown by default.

Authentication tries a personal access token, OAuth, username and password, then a browser-session fallback through the ContextMint Bridge extension. The only write-like tool is canvas_download_file, which fetches only /files/ URLs on your Canvas host and saves inside a download directory.

## Features

- **Child-aware planner:** Look up planner items by observee name or Canvas id.
- **Missing work:** Lists missing submissions and recent submissions.
- **Grades and enrollments:** Reads enrollment records for each course.
- **Announcements and discussions:** Pulls teacher posts and discussion topics.
- **Markdown output:** Converts teacher HTML into Markdown by default.
- **File download:** Saves course files into a restricted download folder.
- **Four sign-in modes:** Token, OAuth, password or browser session.

## Good for

- See what is due this week for each child
- Find missing assignments across courses
- Read new teacher announcements
- Check grades and recent submissions
- Download a course file

## Install

### Claude Code (Terminal)

```sh
claude mcp add canvas-parent-mcp --env CANVAS_BASE_URL='<CANVAS_BASE_URL>' --env CANVAS_PASSWORD='<CANVAS_PASSWORD>' --env CANVAS_TOKEN='<CANVAS_TOKEN>' --env CANVAS_CLIENT_SECRET='<CANVAS_CLIENT_SECRET>' --env CANVAS_REFRESH_TOKEN='<CANVAS_REFRESH_TOKEN>' -- npx -y canvas-parent-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "canvas-parent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canvas-parent-mcp"
      ],
      "env": {
        "CANVAS_BASE_URL": "<CANVAS_BASE_URL>",
        "CANVAS_PASSWORD": "<CANVAS_PASSWORD>",
        "CANVAS_TOKEN": "<CANVAS_TOKEN>",
        "CANVAS_CLIENT_SECRET": "<CANVAS_CLIENT_SECRET>",
        "CANVAS_REFRESH_TOKEN": "<CANVAS_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "canvas-parent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canvas-parent-mcp"
      ],
      "env": {
        "CANVAS_BASE_URL": "<CANVAS_BASE_URL>",
        "CANVAS_PASSWORD": "<CANVAS_PASSWORD>",
        "CANVAS_TOKEN": "<CANVAS_TOKEN>",
        "CANVAS_CLIENT_SECRET": "<CANVAS_CLIENT_SECRET>",
        "CANVAS_REFRESH_TOKEN": "<CANVAS_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "canvas-parent-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "canvas-parent-mcp"
      ],
      "env": {
        "CANVAS_BASE_URL": "<CANVAS_BASE_URL>",
        "CANVAS_PASSWORD": "<CANVAS_PASSWORD>",
        "CANVAS_TOKEN": "<CANVAS_TOKEN>",
        "CANVAS_CLIENT_SECRET": "<CANVAS_CLIENT_SECRET>",
        "CANVAS_REFRESH_TOKEN": "<CANVAS_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "canvas-parent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canvas-parent-mcp"
      ],
      "env": {
        "CANVAS_BASE_URL": "<CANVAS_BASE_URL>",
        "CANVAS_PASSWORD": "<CANVAS_PASSWORD>",
        "CANVAS_TOKEN": "<CANVAS_TOKEN>",
        "CANVAS_CLIENT_SECRET": "<CANVAS_CLIENT_SECRET>",
        "CANVAS_REFRESH_TOKEN": "<CANVAS_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "canvas-parent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "canvas-parent-mcp"
      ],
      "env": {
        "CANVAS_BASE_URL": "<CANVAS_BASE_URL>",
        "CANVAS_PASSWORD": "<CANVAS_PASSWORD>",
        "CANVAS_TOKEN": "<CANVAS_TOKEN>",
        "CANVAS_CLIENT_SECRET": "<CANVAS_CLIENT_SECRET>",
        "CANVAS_REFRESH_TOKEN": "<CANVAS_REFRESH_TOKEN>"
      }
    }
  }
}
```

## Tools

- `canvas_get_profile`: Profile of the signed-in user.
- `canvas_list_observees`: Students the parent observes.
- `canvas_list_courses`: Courses.
- `canvas_get_course`: One course.
- `canvas_list_assignments`: Assignments.
- `canvas_list_missing_submissions`: Missing submissions.
- `canvas_get_submission`: One submission.
- `canvas_list_recent_submissions`: Recent submissions, default 14-day window.
- `canvas_list_enrollments`: Enrollments and grades.
- `canvas_list_calendar_events`: Calendar events.
- `canvas_list_upcoming_events`: Upcoming events.
- `canvas_list_planner_items`: Planner items by child.
- `canvas_list_announcements`: Announcements.
- `canvas_list_conversations`: Inbox conversations.
- `canvas_get_conversation`: One conversation.
- `canvas_list_discussion_topics`: Discussion topics.
- `canvas_list_course_files`: Course files.
- `canvas_download_file`: Downloads a file from your Canvas host.

## FAQ

### Which Canvas servers work?

It targets cms.instructure.com by default but works against any Canvas instance via CANVAS_BASE_URL.

### Can it submit work or post messages?

The tool list is read-focused: only canvas_download_file is flagged as a write or IO operation.

### How does it authenticate?

In priority order: personal access token, OAuth, username and password, or a browser session read through ContextMint Bridge.

### Where do downloads go?

Into CANVAS_OUTPUT_DIR, or ~/Downloads if unset, never through a symlink.

### Is Canvas Parent MCP free?

Yes. Canvas Parent MCP is open source, so you can use and self-host it for free.

### How do I add Canvas Parent MCP to Claude Code?

Run this command in your terminal: claude mcp add canvas-parent-mcp --env CANVAS_BASE_URL='<CANVAS_BASE_URL>' --env CANVAS_PASSWORD='<CANVAS_PASSWORD>' --env CANVAS_TOKEN='<CANVAS_TOKEN>' --env CANVAS_CLIENT_SECRET='<CANVAS_CLIENT_SECRET>' --env CANVAS_REFRESH_TOKEN='<CANVAS_REFRESH_TOKEN>' -- npx -y canvas-parent-mcp

### What are the best alternatives to Canvas Parent MCP?

The closest alternatives to Canvas Parent MCP are Penline Handwriting Sheets, Lumen, Education Mcp, Born Then and FreeDict.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Penline Handwriting Sheets](https://ai-powered.com/mcp/penline-handwriting-sheets): Penline Handwriting Sheets is an MCP server for education and exams.
- [Lumen](https://ai-powered.com/mcp/lumen-4): Lumen is an open-source MCP server for education and exams.
- [Education Mcp](https://ai-powered.com/mcp/education-mcp): Education Mcp is a freemium MCP server for education and exams.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [FreeDict](https://ai-powered.com/mcp/freedict): FreeDict is a freemium MCP server for language learning.
- [Extraudinary](https://ai-powered.com/mcp/extraudinary): Extraudinary is a freemium MCP server for education and exams.
- [Scormbusters](https://ai-powered.com/mcp/scormbusters): Scormbusters is an MCP server for education and exams.
- [Dengdeng Chinese Dictionary](https://ai-powered.com/mcp/dengdeng-chinese-dictionary): Dengdeng Chinese Dictionary is a free MCP server for language learning.

---
Source: https://ai-powered.com/mcp/canvas-parent-mcp
