@rishblob/canvas-mcp-server
Provides tools for interacting with Canvas LMS, including courses, assignments, submissions, modules, pages, discussions, announcements, files, users, enrollments, conversations, and calendar events.
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., "@@rishblob/canvas-mcp-server list my 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.
@rishblob/canvas-mcp-server
TypeScript MCP server for Canvas LMS. It runs over stdio and exposes Canvas API workflows for courses, assignments, submissions, modules, pages, discussions, announcements, files, users, enrollments, conversations, calendar, and utility endpoints.
This package is published to npm as @rishblob/canvas-mcp-server.
Requirements
Node.js
>=18Canvas API token
Related MCP server: mcp-server-canvas-lms
Environment variables
CANVAS_API_TOKENrequired: Canvas bearer token for API authentication.CANVAS_BASE_URLoptional: Canvas host URL (example:https://school.instructure.com).
If CANVAS_BASE_URL is omitted, the server defaults to https://houstonisd.instructure.com.
Install and run locally
npm install
npm run build
npm startFor one-shot local development:
npm run devUse as a published npm package
npx -y @rishblob/canvas-mcp-server
# or
bunx @rishblob/canvas-mcp-serverMCP client configuration
Option 1: Run from local build
{
"mcpServers": {
"canvas": {
"command": "node",
"args": ["/absolute/path/to/canvas-mcp-server/dist/index.js"],
"env": {
"CANVAS_API_TOKEN": "your-canvas-token",
"CANVAS_BASE_URL": "https://school.instructure.com"
}
}
}
}Option 2: Run from npm (recommended)
{
"mcpServers": {
"canvas": {
"command": "npx",
"args": ["-y", "@rishblob/canvas-mcp-server"],
"env": {
"CANVAS_API_TOKEN": "your-canvas-token",
"CANVAS_BASE_URL": "https://school.instructure.com"
}
}
}
}Available MCP tools
Courses:
list_courses,get_course,list_students,get_course_settingsAssignments/submissions:
list_assignments,get_assignment,create_assignment,update_assignment,list_submissions,get_submission,grade_submissionUsers:
get_user_profile,get_user,list_course_usersAnnouncements:
list_announcements,create_announcementModules:
list_modules,get_module,list_module_itemsDiscussions:
list_discussions,get_discussion,create_discussion,list_discussion_entriesCalendar:
list_calendar_events,create_calendar_eventFiles:
list_files,get_file,list_foldersPages:
list_pages,get_page,create_page,update_pageEnrollments:
list_enrollments,get_user_enrollmentsConversations:
list_conversations,get_conversation,create_conversationMisc:
list_todo_items,search_courses,get_course_activity_stream
Publish to npm
npm login
npm publishprepack runs npm run build, so package artifacts are built automatically before publish.
Available Tools
40 toolscreate_announcementB
Create an announcement in a course
Inputs: title (required), message (required), course_id (required).
create_assignmentC
Create a new assignment in a Canvas course
Inputs: name (required), course_id (required), due_at, published, +3 more.
create_calendar_eventD
Create a calendar event
Inputs: title (required), start_at (required), context_code (required), end_at, +2 more.
create_conversationC
Send a new message
Inputs: body (required), subject (required), recipients (required), course_id.
create_discussionB
Create a discussion topic
Inputs: title (required), message (required), course_id (required), published, +1 more.
create_pageC
Create a wiki page
Inputs: body (required), title (required), course_id (required), published.
get_assignmentA
Get details of a specific Canvas assignment
Inputs: course_id (required), assignment_id (required).
get_conversationB
Get a specific conversation
Inputs: conversation_id (required).
get_courseA
Get detailed information about a specific Canvas course, including syllabus, term, teachers, and student count.
Inputs: course_id (required).
get_course_activity_streamB
Get recent activity for a course
Inputs: course_id (required).
get_course_settingsB
Get the settings for a specific Canvas course.
Inputs: course_id (required).
get_discussionC
Get a specific discussion topic
Inputs: topic_id (required), course_id (required).
get_fileC
Get file details
Inputs: file_id (required).
get_moduleC
Get a specific module
Inputs: course_id (required), module_id (required).
get_pageC
Get a specific wiki page
Inputs: course_id (required), url_or_id (required).
get_submissionB
Get a specific student submission for a Canvas assignment
Inputs: user_id (required), course_id (required), assignment_id (required).
get_userB
Get a specific user's profile
Inputs: user_id (required).
get_user_enrollmentsC
List enrollments for a user
Inputs: state, user_id, per_page.
get_user_profileA
Get the current user's profile
Inputs: no named parameters.
grade_submissionC
Grade a student submission for a Canvas assignment
Inputs: grade (required), user_id (required), course_id (required), assignment_id (required), +1 more.
list_announcementsB
List announcements for a course
Inputs: course_id (required), end_date, per_page, start_date.
list_assignmentsB
List assignments for a Canvas course
Inputs: course_id (required), order_by, per_page.
list_calendar_eventsC
List calendar events
Inputs: end_date, per_page, start_date, context_codes.
list_conversationsA
List conversations for the current user
Inputs: scope, per_page.
list_coursesA
List all courses for the current user. Optionally filter by enrollment type and course state.
Inputs: state, per_page, enrollment_type.
list_course_usersC
List users in a course
Inputs: course_id (required), per_page, enrollment_type.
list_discussion_entriesB
List entries (replies) in a discussion
Inputs: topic_id (required), course_id (required), per_page.
list_discussionsC
List discussion topics in a course
Inputs: course_id (required), order_by, per_page.
list_enrollmentsC
List enrollments in a course
Inputs: course_id (required), type, state, per_page.
list_filesC
List files in a course
Inputs: course_id (required), sort, per_page, search_term.
list_foldersA
List folders in a course
Inputs: course_id (required).
list_module_itemsB
List items in a module
Inputs: course_id (required), module_id (required), per_page.
list_modulesC
List modules in a course
Inputs: course_id (required), per_page.
list_pagesB
List wiki pages in a course
Inputs: course_id (required), sort, per_page.
list_studentsB
List all students enrolled in a specific Canvas course, including their email and enrollment details.
Inputs: course_id (required), per_page.
list_submissionsB
List submissions for a Canvas assignment
Inputs: course_id (required), assignment_id (required), per_page.
list_todo_itemsA
List the current user's todo items
Inputs: no named parameters.
search_coursesB
Search for courses across the account
Inputs: search_term (required), per_page.
update_assignmentB
Update an existing assignment in a Canvas course
Inputs: course_id (required), assignment_id (required), name, due_at, +3 more.
update_pageC
Update a wiki page
Inputs: course_id (required), url_or_id (required), body, title, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Each tool targets a distinct Canvas resource and action, such as list vs get vs create for courses, assignments, discussions, and pages. Even similar tools like list_students and list_course_users are differentiated by student-only versus all users. No two tools appear to do the same thing.
Tool names uniformly follow a verb_noun snake_case pattern (list_*, get_*, create_*, update_*, grade_*, search_*). The resource name is consistently placed after the verb, making the API highly predictable.
At 40 tools, the surface is quite large and exceeds the 25+ threshold for a coherent set. While Canvas has many resource types, the count feels heavy and may overwhelm agents compared with a more focused subset.
Core workflows like listing courses, assignments, submissions, and grading are covered, and many resources have list/get/create actions. However, most resource types lack update/delete operations (e.g., announcements, calendar events, discussions, modules, files), leaving notable lifecycle gaps.
Maintenance
Related MCP Connectors
MCP server for the Inistate platform: module discovery, entry management, and activity submission.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
The official MCP Server for the Mux API
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server for Canvas LMS with automatic OAuth authentication. Enables interaction with courses, assignments, grades, modules, discussions, quizzes, files, calendar, messaging, and more without manual API token management.3,565 npm1MIT
- AlicenseAqualityCmaintenanceRead-only MCP server for Canvas LMS that exposes tools to list courses, assignments, grades, submissions, syllabi, announcements, modules, pages, and files, without any write operations.1112 npm1MIT
- AlicenseNot gradedqualityAmaintenanceEnables interaction with Canvas LMS through its API for managing courses, assignments, submissions, enrollments, grades, discussions, files, and account administration via MCP clients.21 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables interaction with Canvas LMS through its API, supporting course, assignment, enrollment, grade, discussion, file, and account administration workflows for students, instructors, and administrators via MCP clients.21 npmMIT