Canvas Parent MCP
MCP server for parents and students to read Canvas LMS courses, grades and due work
- 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-mcpAdd 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.comRequiredCANVAS_USERNAMECanvas login username/email (recommended) — pair with CANVAS_PASSWORD for auto-login. No SSO/2FA.CANVAS_PASSWORDCanvas password (recommended) — required iff CANVAS_USERNAME is setCANVAS_TOKENCanvas personal access token (advanced) — most schools have disabled token creationCANVAS_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-loginCANVAS_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.