Skip to content
MCP server

Canvas Parent MCP

MCP server for parents and students to read Canvas LMS courses, grades and due work

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
2.3.0
Listing updated
today

Similar MCP servers

About Canvas Parent MCP

Canvas Parent MCP is an open-source MCP server for education and exams. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CANVAS_BASE_URLCanvas instance base URL, e.g. https://cms.instructure.comRequired
  • CANVAS_USERNAMECanvas login username/email (recommended) — pair with CANVAS_PASSWORD for auto-login. No SSO/2FA.
  • CANVAS_PASSWORDCanvas password (recommended) — required iff CANVAS_USERNAME is set
  • CANVAS_TOKENCanvas personal access token (advanced) — most schools have disabled token creation
  • CANVAS_CLIENT_IDCanvas OAuth client ID (advanced — for SSO accounts that can't use username/password)
  • CANVAS_CLIENT_SECRETCanvas OAuth client secret (advanced)
  • CANVAS_REFRESH_TOKENCanvas OAuth refresh token (advanced) — bootstrap via canvas-parent-mcp-qr-login
  • CANVAS_NAMEFriendly name for the Canvas instance (defaults to the host portion of the base URL)
  • CANVAS_SESSION_CACHESet to false to disable the on-disk session cache and re-authenticate on every process start. Defaults to enabled.
  • CANVAS_SESSION_FILEAbsolute path for the session cache file. Defaults to $MCP_DATA_DIR/.canvas-parent-mcp/session.json.
  • CANVAS_OUTPUT_DIRDirectory canvas_download_file may write into (default ~/Downloads). A relative destinationPath is resolved against it.
  • CANVAS_DISABLE_FETCHPROXYSet to 1 to turn off the browser (fetchproxy) fallback, so missing credentials are a hard error instead.
  • FETCHPROXY_WS_PORTLocalhost port of the fetchproxy concentrator the ContextMint Bridge extension connects to (default 37149). Every MCP on one machine shares it, so move it for all of them or not at all.
  • FETCHPROXY_WS_HOSTBind interface for the fetchproxy concentrator, a literal IP only (default 127.0.0.1). Keep on loopback; it exists for hosted deployments that run each MCP in its own network namespace.
  • FETCHPROXY_IDENTITY_DIRAbsolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

Tools this server provides (18)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Canvas Parent MCP 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.

How AIPoweredBot checks servers