Canvas MCP Server
This server lets AI assistants manage Canvas LMS courses, assignments, submissions, rubrics, modules, files, pages, quizzes, and ePortfolios via natural language, with privacy features.
Courses: List active courses and post announcements.
Students: List students with optional anonymization of names/emails.
Assignments: Create, read, update, delete assignments; manage assignment groups; bulk-update due dates.
Submissions: View submissions, grade them, add comments, fetch documents/file info, download files.
Sections: List sections and section-specific submissions.
Rubrics: List rubrics, get statistics, view assessments, attach rubrics to assignments.
Modules: Full CRUD for modules and module items, plus publish toggling.
Files: Browse folders, files, and folder contents.
Pages: Read, update, patch, revert pages; generate and get styleguides.
Quizzes: Full CRUD for quizzes, questions, and question groups.
ePortfolios: List and retrieve ePortfolios and their pages.
Analysis prompt:
analyze-rubric-statisticscreates visualizations for formative assignments.
Provides tools for managing Canvas LMS courses, announcements, rubrics, assignments, modules, pages, quizzes, and student data, including privacy-preserving anonymization.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Canvas MCP Server list my active courses"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Canvas MCP Server
Connect AI assistants to Canvas LMS — manage courses, grade submissions, edit pages, and analyze rubrics through natural conversation.
Quick Start
Get a Canvas API token — Canvas → Account → Settings → Approved Integrations → New Access Token
Install via Claude Desktop Extension or
npx @r-huijts/canvas-mcpTry a prompt — "List all my active Canvas courses"
Related MCP server: Canvas MCP Server
Table of Contents
Features
Courses — list active courses, post announcements
Assignments — create, update, delete assignments and assignment groups; bulk date updates
Submissions — grade work, post feedback, download submission files
Rubrics — view rubrics, analyze statistics, attach rubrics to assignments
Students — enrollment lists with privacy-first anonymization
Sections — list sections and section-filtered submissions
Modules — full module and module-item CRUD
Files — browse the course Files section: folder trees, file lists, and per-folder contents
Pages — edit content, manage revisions, and use the styleguide system (
generate-styleguide,patch-page-content)Quizzes — full quiz, question, and question-group CRUD
Quiz results — per-student answers, item analysis, report generation, and regrading
ePortfolios — list and read student ePortfolios
Prompts —
analyze-rubric-statisticsfor multi-assignment rubric visualizationsPerformance — ETag-based response caching to reduce API load and token use
69 tools and 1 prompt in total. See docs/TOOLS.md for the full parameter reference.
Prerequisites
Node.js v16 or higher (for npm/source installs; not required for the Desktop Extension)
A Canvas API token with access to the courses you intend to manage
Your Canvas instance URL (e.g.
https://yourschool.instructure.com)
Note: The server defaults to
https://fhict.instructure.comifCANVAS_BASE_URLis not set. Set this variable to your own institution's Canvas URL.
Installation
Option 1: Desktop Extension (Easiest)
One-click installation with Claude Desktop Extensions:
Download the latest extension from GitHub Releases (
.mcpbor.dxtformat, depending on the release)Open the file with Claude Desktop (double-click or drag-and-drop)
Click "Install"
Configure your Canvas API token and base URL through the Claude Desktop UI
Benefits: no terminal required, secure token storage in the OS keychain, bundled dependencies, cross-platform (macOS and Windows).
To build the extension yourself, see DESKTOP_EXTENSION.md.
Option 2: NPM Package (Recommended)
npm install -g @r-huijts/canvas-mcpOr run directly without installing:
npx @r-huijts/canvas-mcpOption 3: From Source
git clone https://github.com/r-huijts/canvas-mcp
cd canvas-mcp
npm install
cp .env.example .env # then edit with your credentials
npm run build
npm startFor development with auto-reload:
npm run devConfiguration
Set these environment variables (via .env file, MCP client config, or shell):
Variable | Required | Description |
| Yes | Personal access token from Canvas |
| No | Your Canvas instance URL (default: |
See .env.example for a template.
Getting a Canvas API Token
Log in to your Canvas instance
Go to Account → Settings → Approved Integrations
Click + New Access Token
Copy the token — you won't be able to see it again
Your token must belong to a user with teacher (or equivalent) access to the courses you want to manage. Canvas personal access tokens inherit the permissions of the account that created them.
Claude Desktop Integration
Open Claude Desktop's configuration file:
macOS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
code %AppData%\Claude\claude_desktop_config.jsonAdd the Canvas MCP server:
NPM package (recommended):
{ "mcpServers": { "canvas": { "command": "npx", "args": ["-y", "@r-huijts/canvas-mcp"], "env": { "CANVAS_API_TOKEN": "your_token_here", "CANVAS_BASE_URL": "https://your-canvas-instance.com" } } } }From source:
{ "mcpServers": { "canvas": { "command": "node", "args": ["/absolute/path/to/canvas-mcp/dist/index.js"], "env": { "CANVAS_API_TOKEN": "your_token_here", "CANVAS_BASE_URL": "https://your-canvas-instance.com" } } } }Restart Claude Desktop
The -y flag tells npx to accept the package installation prompt automatically.
Other MCP Clients
Any MCP client that supports stdio transport can use the same configuration pattern. Replace the config file path with your client's equivalent:
{
"mcpServers": {
"canvas": {
"command": "npx",
"args": ["-y", "@r-huijts/canvas-mcp"],
"env": {
"CANVAS_API_TOKEN": "your_token_here",
"CANVAS_BASE_URL": "https://your-canvas-instance.com"
}
}
}
}This works with Cursor, VS Code MCP extensions, and other stdio-based clients. Consult your client's MCP documentation for where to place the config file.
Usage Examples
Copy-paste these prompts into your AI assistant after connecting the server:
List all my active Canvas coursesPost an announcement to course 12345 titled "Week 3 Update" with a summary of this week's topicsShow rubric statistics for assignment 67890 in course 12345List all folders and files in the Files section of course 12345Generate a styleguide for course 12345, then patch the syllabus page to match itList all students in course 12345 with their actual names and emailsStudent Data Privacy
This server includes privacy-first anonymization for student data. By default, student names and emails are pseudonymized; you can request real identities using natural language.
Default behavior:
Names become
Student 1,Student 2, etc.Emails become
student1@example.com,student2@example.comThe same student always gets the same pseudonym across calls
Teacher and admin names are never anonymized
Requesting real data:
List all students in course 123, but show their actual names and emailsAffected tools: list-students, list-assignments (with submission data), list-assignment-submissions, list-section-submissions, list-rubric-assessments, get-submission-documents
Each affected tool accepts an anonymous parameter (default: true). Your AI assistant sets anonymous: false when you ask for real names.
The anonymization system targets student privacy while preserving educational context:
Students are the protected population whose privacy needs safeguarding
Knowing which instructor provided feedback is pedagogically valuable
Comments include an
author.rolefield — onlyrole === 'student'authors are anonymized
Example with anonymization enabled:
✅ "Excellent analysis! - Prof. Johnson"
❌ "I found this confusing - Student 1"If you need full anonymization including staff, you can modify the logic in src/anonymizer.ts.
Tool Reference
Category | Count | Tools |
Courses | 2 |
|
Students | 1 |
|
Assignments | 5 |
|
Assignment Groups | 3 |
|
Submissions | 6 |
|
Sections | 2 |
|
Rubrics | 4 |
|
Modules | 10 |
|
Files | 3 |
|
Pages | 9 |
|
Quizzes | 15 |
|
Quiz Results | 6 |
|
ePortfolios | 3 |
|
Full parameter reference: docs/TOOLS.md
Available Prompts
analyze-rubric-statistics
Analyzes rubric statistics for formative assignments in a course and creates visualizations.
Required:
courseName(string)Creates grouped stacked bar and grouped bar charts across assignments and criteria
Includes progression analysis and trend identification
Troubleshooting
Server not appearing in Claude Desktop
Verify JSON syntax in your config file
Use absolute paths for source installs (
dist/index.js, notbuild/index.js)Ensure your Canvas API token is valid
Restart Claude Desktop
Connection errors
Confirm your token has access to the target courses
Verify
CANVAS_BASE_URLpoints to your institution's Canvas instanceCheck MCP logs:
# macOS tail -f ~/Library/Logs/Claude/mcp*.log # Windows type %AppData%\Claude\Logs\mcp*.log
NPX issues
On Windows, ensure npm/npx are on your PATH
For permission errors, try running Claude Desktop as administrator (Windows)
Corporate networks may require npm proxy configuration
Debug logging
The server logs errors to stderr. Redirect when running manually:
node dist/index.js 2> debug.logPerformance & Caching
The server caches stable Canvas API responses to avoid redundant fetches and reduce token consumption.
How it works:
First request stores the response body and any
ETagorLast-ModifiedheaderSubsequent requests send conditional GETs (
If-None-Match/If-Modified-Since); Canvas returns304 Not Modifiedwhen data is unchangedIf Canvas omits validator headers, a 30-minute TTL is used as fallback
Write operations (
POST,PUT,DELETE) evict affected cache entries
What is never cached:
Submission and grade data (
/submissionsendpoints) — always fetched livePaginated
fetchAllPages()calls (students, submissions, ePortfolios) bypass the ETag cache and always hit the network — relevant for large courses
Development
Architecture
MCP Client → stdio → src/index.ts → src/tools/* → CanvasClient → Canvas REST APIKey modules:
src/index.ts— server bootstrap and tool registrationsrc/canvasClient.ts— HTTP client, ETag caching, paginationsrc/anonymizer.ts— student data pseudonymizationsrc/tools/— one file per domain, each exportsregister*Tools()
Tool registration
This server uses the MCP TypeScript SDK (v1.29.0). Each tool is registered with server.tool() using a five-argument form:
Tool name (string)
Tool description (string)
Input schema (Zod schema)
Tool annotations (
{ readOnlyHint?, destructiveHint?, idempotentHint? })Execute function
server.tool(
"list-courses",
"List all active courses for the authenticated user. Returns course name, ID, course code, and term.",
{},
{ readOnlyHint: true },
async () => {
return {
content: [{ type: "text", text: "..." }]
};
}
);Local development
npm install
npm run build # compile TypeScript to dist/
npm start # run compiled server
npm run dev # run from source with tsx (hot reload)Contributing
Fork the repository
Create a feature branch
Install dependencies:
npm installBuild:
npm run buildSubmit a pull request
There is currently no automated test suite — manual verification via an MCP client is the primary testing approach.
Security Notes
API token security
Never commit your Canvas API token to version control
Use environment variables or secure configuration
Rotate tokens periodically
Permissions
Use tokens with the minimum access needed for your use case
Review Canvas API access logs periodically
Related Documentation
docs/TOOLS.md — full tool parameter reference
DESKTOP_EXTENSION.md — building and packaging the Claude Desktop Extension
.env.example — environment variable template
License
MIT — see LICENSE.
Available Tools
60 toolsapply-page-changesAIdempotent
Write revised HTML content to a Canvas page. Accepts the full new body as newContent and saves it. Intended as the second step after patch-page-content.
Inputs: pageUrl (required), courseId (required), newContent (required), title, +1 more.
attach-rubric-to-assignmentBIdempotent
Attach a rubric to an assignment.
Inputs: courseId (required), rubricId (required), assignmentId (required).
bulk-update-assignment-datesAIdempotent
Bulk update due/unlock/lock dates for assignments in a course.
Inputs: courseId (required), assignmentDates (required).
create-assignmentB
Create a new assignment in a course. All fields are optional except courseId.
Inputs: courseId (required), name, due_at, published, +5 more.
create-assignment-groupB
Create a new assignment group (bucket) in a course. All fields optional except courseId.
Inputs: courseId (required), name, rules, position, +3 more.
create-moduleA
Create a new module in a course.
Inputs: name (required), courseId (required), position, unlock_at, +3 more.
create-module-itemA
Add a new item to a module. Type must be one of: File, Page, Discussion, Assignment, Quiz, SubHeader, ExternalUrl, ExternalTool.
Inputs: type (required), courseId (required), moduleId (required), title, +8 more.
create-quizB
Create a new quiz in a course.
Inputs: title (required), courseId (required), due_at, published, +3 more.
create-quiz-questionA
Create a new question in a quiz.
Inputs: quizId (required), courseId (required), question (required).
create-quiz-question-groupA
Create a new question group in a quiz.
Inputs: quizId (required), courseId (required), quizGroup (required).
delete-assignmentADestructive
Delete (archive) an assignment from a course.
Inputs: courseId (required), assignmentId (required).
delete-moduleADestructive
Delete a module from a course. This is permanent and removes all module items.
Inputs: courseId (required), moduleId (required).
delete-module-itemADestructive
Remove an item from a module.
Inputs: itemId (required), courseId (required), moduleId (required).
delete-quizBDestructive
Delete a quiz from a course.
Inputs: quizId (required), courseId (required).
delete-quiz-questionBDestructive
Delete a question from a quiz.
Inputs: quizId (required), courseId (required), questionId (required).
delete-quiz-question-groupADestructive
Delete a question group from a quiz.
Inputs: quizId (required), groupId (required), courseId (required).
download-submission-fileARead-only
Download the actual content of a file attached to a submission. Returns file content as base64 for binary files or as text for text files.
Inputs: fileId (required), forceBase64.
generate-styleguideAIdempotent
Generate and save a Canvas styleguide page for a course with design standards, accessibility guidelines, and Canvas-specific formatting best practices. Creates the page at the given URL slug (default: canvas-styleguide).
Inputs: courseId (required), slug, customBranding, includeExamples.
get-assignmentARead-only
Fetch metadata for a single assignment (due date, points, rubric, submission types, etc).
Inputs: courseId (required), assignmentId (required).
get-eportfolioARead-only
Get details for a single ePortfolio by ID.
Inputs: eportfolioId (required).
get-eportfolio-pagesARead-only
List all pages in an ePortfolio. Returns id, position, name, content, and timestamps for each page.
Inputs: eportfolioId (required).
get-module-itemARead-only
Get details for a single module item.
Inputs: itemId (required), courseId (required), moduleId (required).
get-page-contentARead-only
Get the full content of a page by URL slug. Returns title, URL slug, page ID, published status, last-updated timestamp, and HTML body.
Inputs: pageUrl (required), courseId (required).
get-quizARead-only
Fetch metadata for a single quiz
Inputs: quizId (required), courseId (required).
get-quiz-questionBRead-only
Fetch a single question from a quiz
Inputs: quizId (required), courseId (required), questionId (required).
get-quiz-question-groupARead-only
Fetch a single question group from a quiz
Inputs: quizId (required), groupId (required), courseId (required).
get-rubric-statisticsARead-only
Get statistics for rubric assessments on an assignment
Inputs: courseId (required), assignmentId (required), includePointDistribution.
get-styleguideARead-only
Fetch the Canvas styleguide page for a course. Returns the page title, last-updated timestamp, and full HTML body.
Inputs: courseId (required), slug.
get-submission-documentsARead-only
Retrieve a student's submission with attachment metadata and optional file downloads. Returns submission details, file information, and optionally the actual file content.
Inputs: userId (required), courseId (required), assignmentId (required), anonymous, +1 more.
get-submission-file-infoARead-only
Get detailed information about a specific file attached to a submission, including download URLs and metadata.
Inputs: fileId (required).
grade-submissionCIdempotent
Write back a score, grade, rubric points, or comment for a student's submission.
Inputs: userId (required), courseId (required), assignmentId (required), score, +3 more.
list-assignment-groupsARead-only
List all assignment groups (buckets) in a course.
Inputs: courseId (required).
list-assignmentsARead-only
Get a list of all assignments in a course with submission status for students
Inputs: courseId (required), anonymous, studentId, includeSubmissionHistory.
list-assignment-submissionsBRead-only
Fetch every student's submission status & comments for an assignment.
Inputs: courseId (required), assignmentId (required), anonymous.
list-coursesARead-only
List all active courses for the authenticated user. Returns course name, ID, course code, and term for each course.
Inputs: no named parameters.
list-eportfoliosARead-only
List all ePortfolios belonging to a user. Returns id, name, public flag, workflow state, and timestamps.
Inputs: userId (required).
list-module-itemsARead-only
Given a module ID, list its items (pages, quizzes, files, etc).
Inputs: courseId (required), moduleId (required).
list-modulesARead-only
Return all modules in a course (optionally inline items).
Inputs: courseId (required), includeItems.
list-page-revisionsARead-only
List all revisions for a page.
Inputs: pageUrl (required), courseId (required).
list-pagesARead-only
List all pages in a course. Returns title, URL slug, page ID, and published status for each page.
Inputs: courseId (required).
list-quiz-question-groupsARead-only
Get a list of all question groups in a quiz
Inputs: quizId (required), courseId (required).
list-quiz-questionsARead-only
Get a list of all questions in a quiz
Inputs: quizId (required), courseId (required).
list-quizzesBRead-only
Get a list of all quizzes in a course
Inputs: courseId (required).
list-rubric-assessmentsBRead-only
List all rubric assessments for an assignment.
Inputs: courseId (required), assignmentId (required), anonymous.
list-rubricsARead-only
List all rubrics in a course. Returns rubric title, ID, and description for each rubric.
Inputs: courseId (required).
list-sectionsARead-only
List all sections in a course. Returns section name, ID, SIS ID, and optional date ranges. Set includeStudentCount to include enrollment totals per section.
Inputs: courseId (required), includeStudentCount.
list-section-submissionsARead-only
Get all student submissions for a specific assignment filtered by section
Inputs: courseId (required), sectionId (required), assignmentId (required), anonymous, +1 more.
list-studentsBRead-only
Get a complete list of all students enrolled in a specific course
Inputs: courseId (required), anonymous, includeEmail.
patch-page-contentARead-only
Fetch a page's current HTML body and return it alongside edit instructions for the model to apply. Does not write to Canvas — follow up with apply-page-changes to persist the result. Optionally includes the course styleguide for formatting reference. For full replacement, use update-page-content instead.
Inputs: pageUrl (required), courseId (required), instructions (required), title, +2 more.
post-announcementB
Post an announcement to a specific course
Inputs: title (required), message (required), courseId (required).
post-submission-commentA
Attach targeted feedback as a comment on a student's submission.
Inputs: userId (required), comment (required), courseId (required), assignmentId (required).
revert-page-revisionAIdempotent
Revert a page to a previous revision.
Inputs: pageUrl (required), courseId (required), revisionId (required).
toggle-module-publishA
Publish/unpublish a module (toggles the current published state).
Inputs: courseId (required), moduleId (required).
update-assignmentBIdempotent
Update an assignment. All fields are optional except courseId and assignmentId.
Inputs: courseId (required), assignmentId (required), name, due_at, +6 more.
update-moduleCIdempotent
Update an existing module's name, position, prerequisites, sequential progress, or published state.
Inputs: courseId (required), moduleId (required), name, position, +5 more.
update-module-itemAIdempotent
Update an existing module item's title, position, indent, external URL, published state, completion requirement, or move it to another module.
Inputs: itemId (required), courseId (required), moduleId (required), title, +8 more.
update-page-contentAIdempotent
Update or create a page with new content, replacing the entire body. If no body/title/editingRoles is provided, nothing is written and guidance is returned (set showStyleguidePreview to also inline the styleguide). For targeted edits to existing content, use patch-page-content instead.
Inputs: pageUrl (required), courseId (required), body, title, +3 more.
update-quizCIdempotent
Update an existing quiz in a course.
Inputs: quizId (required), courseId (required), title, due_at, +4 more.
update-quiz-questionCIdempotent
Update an existing question in a quiz.
Inputs: quizId (required), courseId (required), question (required), questionId (required).
update-quiz-question-groupAIdempotent
Update an existing question group in a quiz.
Inputs: quizId (required), groupId (required), courseId (required), quizGroup (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 60 tools
Most tools clearly target distinct resources and actions, but there is some potential overlap between patch-page-content and update-page-content (targeted vs full replacement) and among get-submission-documents, get-submission-file-info, and download-submission-file. Descriptions generally help distinguish them.
All tool names follow a consistent lowercase hyphenated verb-noun pattern (e.g., list-pages, create-module, delete-quiz). This consistency makes it easy to predict tool behavior from the name alone.
With 60 tools, this exceeds the 50+ threshold for extreme mismatch per the calibration guide. Even for a broad LMS like Canvas, the surface is overwhelming and could benefit from splitting into focused servers by domain (e.g., quizzes, assignments, pages).
Core teaching workflows are well covered: assignments, quizzes, pages, modules, submissions, and grading. However, there are notable gaps: announcements only support post (no list/delete), eportfolios lack create/update/delete, and there is no discussion management or course settings beyond basic listing.
Maintenance
Related MCP Connectors
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Manage your Canvas coursework with quick access to courses, assignments, and grades. Track upcomin…
Create, edit, translate, and export SCORM eLearning modules from a connected AI assistant.
Design and edit Bloom canvases from AI coding agents with browser OAuth.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants like Claude to interact with Canvas LMS through the Canvas API, providing tools for managing courses, announcements, rubrics, assignments, and student data.1011 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Canvas LMS through 25 comprehensive tools. Supports course management, assignments, grades, messaging, calendar events, and file access through natural language.3,290 npm14MIT
- AlicenseAqualityDmaintenanceEnables AI systems to interact with Canvas Learning Management System data, allowing users to access courses, assignments, quizzes, planner items, files, and syllabi through natural language queries.2242 PyPI7MIT
- FlicenseBqualityBmaintenanceEnables AI assistants to act as teaching assistants for Canvas LMS, allowing them to browse courses, read student submissions (including PDF/DOCX), grade with rubrics, post announcements, manage modules and pages, and more.64-