Canvas LMS MCP Server
Provides access to Canvas LMS education data, including courses, assignments, quizzes, syllabus content, course modules, files, and planner items for enrolled students.
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 LMS MCP Server what assignments are due this week in my math course?"
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 LMS MCP Server
A minimal Canvas LMS MCP (Machine Conversation Protocol) server for easy access to education data through your Canvas LMS instance. This server provides a bridge between AI systems (like Cursor) and Canvas Learning Management System.
Features
Courses: List enrolled courses, get course details, syllabus, modules, and module items
Assignments: List and get assignments with optional submission status
Pages: Get course pages by URL slug
Submissions: List your own submissions with grades and feedback
Announcements: List announcements across multiple courses
Discussions: List topics and view full discussion threads
Calendar: List calendar events with date filtering
Planner: List planner items (assignments, announcements, etc.)
Enrollments: Get enrollment data with grades
Quizzes: List and get quizzes (classic quizzes only)
Files: List and get files
Navigation: Get course tabs, assignment groups, and favorite courses
Related MCP server: Canvas Assignment Assistant
Installation
Installing via Smithery
To install Canvas LMS Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @ahnopologetic/canvas-lms-mcp --client claudePrerequisites
Python 3.13+
Canvas LMS API token
uvpackage manager (recommended)
Installation Methods
Option 1: Install with uvx (Recommended)
The easiest way to install and run canvas-lms-mcp is using uvx:
uvx canvas-lms-mcpThis will run the server in an isolated environment without installing it permanently.
To install the tool permanently:
uv tool install canvas-lms-mcpOption 2: Install from Source
Clone the repository:
git clone https://github.com/yourusername/canvas-lms-mcp.git cd canvas-lms-mcpInstall with uv:
# Install uv if you don't have it yet curl -LsSf https://astral.sh/uv/install.sh | sh # Create a virtual environment and install dependencies uv venv uv pip install -e .Alternatively, use traditional methods:
python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate pip install -e .
Configuration
Set the following environment variables:
export CANVAS_API_TOKEN="your_canvas_api_token"
export CANVAS_BASE_URL="https://your-institution.instructure.com" # Default: https://canvas.instructure.comYou can get your Canvas API token from your Canvas account settings.
Running the Server
Start the server with uv:
uv run src/canvas_lms_mcp/main.pyIf installed with uvx tool:
canvas-lms-mcpBy default, the server runs on http://localhost:8000. You can use the FastMCP interface at http://localhost:8000/docs to interact with the API.
Available Tools
The server provides 22 tools for interacting with Canvas LMS:
Courses
list_courses
List courses that the user is actively enrolled in.
Parameters:
page(optional, default=1): Page number (1-indexed)items_per_page(optional, default=10): Number of items per page
get_course
Get a single course by ID.
Parameters:
course_id(required): Course IDinclude(optional): List of additional data to include
get_course_syllabus
Get a course's syllabus body as HTML.
Parameters:
course_id(required): Course ID
get_course_modules
Get modules for a course.
Parameters:
course_id(required): Course IDinclude(optional): List of additional data to includeper_page(optional, default=100): Number of items per page
get_module_items
Get items for a specific module.
Parameters:
course_id(required): Course IDmodule_id(required): Module ID
Assignments
list_assignments
List assignments for a course.
Parameters:
course_id(required): Course IDbucket(required): Filter by "past", "overdue", "undated", "ungraded", "unsubmitted", "upcoming", or "future"order_by(required): Order by "due_at", "position", or "name"include(optional): List of additional data to include (e.g.,["submission"]to see grade status)page(optional, default=1): Page number (1-indexed)items_per_page(optional, default=10): Number of items per page
get_assignment
Get a single assignment by ID.
Parameters:
course_id(required): Course IDassignment_id(required): Assignment ID
list_assignment_groups
List assignment groups for a course (shows grade weighting/categories).
Parameters:
course_id(required): Course ID
Pages
get_page
Get a single page by its URL slug.
Parameters:
course_id(required): Course IDpage_slug(required): Page URL slug (e.g., "syllabus", "course-handbook")
Submissions
list_submissions
List the current user's submissions for a course, including grades and feedback.
Parameters:
course_id(required): Course IDinclude(optional): List of additional data (e.g.,["assignment", "submission_comments"])page(optional, default=1): Page number (1-indexed)items_per_page(optional, default=10): Number of items per page
Announcements
list_announcements
List announcements for one or more courses.
Parameters:
course_ids(required): List of course IDspage(optional, default=1): Page number (1-indexed)items_per_page(optional, default=10): Number of items per page
Discussions
list_discussions
List discussion topics for a course.
Parameters:
course_id(required): Course IDpage(optional, default=1): Page number (1-indexed)items_per_page(optional, default=10): Number of items per page
get_discussion_view
Get the full view of a discussion topic including all replies.
Parameters:
course_id(required): Course IDdiscussion_id(required): Discussion topic ID
Calendar
list_calendar_events
List calendar events for courses.
Parameters:
context_codes(required): List of context codes (e.g.,["course_123"])start_date(optional): Start date in ISO 8601 formatend_date(optional): End date in ISO 8601 formatpage(optional, default=1): Page number (1-indexed)items_per_page(optional, default=10): Number of items per page
Planner Items
list_planner_items
List planner items for the authenticated user.
Parameters:
start_date(required): Start date in ISO 8601 formatend_date(required): End date in ISO 8601 formatcontext_codes(optional): List of context codes (e.g.,["course_123"])page(optional, default=1): Page number (1-indexed)items_per_page(optional, default=10): Number of items per page
Enrollments
get_enrollments
Get the current user's enrollments including grades.
Quizzes
list_quizzes
List quizzes for a course. Note: only works with Classic Quizzes, not New Quizzes (quiz_lti).
Parameters:
course_id(required): Course IDinclude(optional): List of additional data to includepage(optional, default=1): Page number (1-indexed)items_per_page(optional, default=10): Number of items per page
get_quiz
Get a single quiz by ID.
Parameters:
course_id(required): Course IDquiz_id(required): Quiz ID
Files
list_files
List files for a course or folder. Note: may return 403 for student accounts depending on institution permissions.
Parameters:
course_id(optional): Course IDfolder_id(optional): Folder IDinclude(optional): List of additional data to includepage(optional, default=1): Page number (1-indexed)items_per_page(optional, default=10): Number of items per page
get_file
Get a file by ID. Works with known file IDs even when list_files is restricted.
Parameters:
course_id(required): Course IDfile_id(required): File ID
Other
get_tabs
Get available tabs/navigation items for a course.
Parameters:
course_id(required): Course ID
list_favorites
List the current user's favorite courses.
Integration
This MCP server works with any client that supports the Model Context Protocol, including Claude Desktop, Claude Code, Cursor, Windsurf, and others.
The MCP configuration is the same across all clients — only the config file location differs:
{
"mcpServers": {
"canvas": {
"command": "uvx",
"args": ["canvas-lms-mcp"],
"env": {
"CANVAS_API_TOKEN": "your_canvas_api_token",
"CANVAS_BASE_URL": "https://your-institution.instructure.com"
}
}
}
}Replace your_canvas_api_token with your Canvas API token (found in Canvas → Account → Settings → New Access Token) and your-institution.instructure.com with your institution's Canvas URL.
Claude Desktop
Add to your Claude Desktop config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Restart Claude Desktop after saving.
Claude Code
Add to your project's .mcp.json or global ~/.claude/settings.json:
{
"mcpServers": {
"canvas": {
"command": "uvx",
"args": ["canvas-lms-mcp"],
"env": {
"CANVAS_API_TOKEN": "your_canvas_api_token",
"CANVAS_BASE_URL": "https://your-institution.instructure.com"
}
}
}
}Cursor
Add to .cursor/mcp.json in your project directory. Restart Cursor after saving.
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json. Restart Windsurf after saving.
Usage Examples
Once connected, you can ask your AI assistant about your Canvas data:
"What assignments do I have due next week?"
"Show me the syllabus for my Biology course"
"What announcements were posted today?"
"What are my grades so far?"
"What's on my schedule for tomorrow?"
"Show me the discussion posts for my English class"
Development
For detailed development instructions, please see the DEVELOPMENT.md file.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Available Tools
22 toolsget_assignmentC
Get a single assignment by ID.
Args: course_id: Course ID assignment_id: Assignment ID
Returns: Assignment object
Inputs: course_id (required), assignment_id (required).
get_courseA
Get a single course by ID.
Args: course_id: Course ID include: Optional list of additional data to include
Returns: Course object
Inputs: course_id (required), include.
get_course_modulesC
Get modules for a course.
Args: course_id: Course ID include: Optional list of additional data to include per_page: Number of items per page Returns: List of Module objects
Inputs: course_id (required), include, per_page.
get_course_syllabusB
Get a course's syllabus.
Args: course_id: Course ID
Returns: Course syllabus as string
Inputs: course_id (required).
get_discussion_viewB
Get the full view of a discussion topic including all replies.
Args: course_id: Course ID discussion_id: Discussion topic ID
Returns: Full discussion view with participants and all entries
Inputs: course_id (required), discussion_id (required).
get_enrollmentsA
Get the current user's enrollments including grades.
Returns: Dict with enrollment items including course IDs and grade data
Inputs: no named parameters.
get_fileB
Get a file by ID.
Args: course_id: Course ID file_id: File ID
Returns: File object
Inputs: course_id (required), file_id (required).
get_module_itemsC
Get items for a module.
Args: course_id: Course ID module_id: Module ID
Inputs: course_id (required), module_id (required).
get_pageA
Get a single page by its URL slug.
Args: course_id: Course ID page_slug: Page URL slug (e.g., "kurshandbok", "examination")
Returns: Page object with title, body (HTML), and metadata
Inputs: course_id (required), page_slug (required).
get_quizB
Get a single quiz by ID.
Args: course_id: Course ID quiz_id: Quiz ID
Returns: Quiz object
Inputs: course_id (required), quiz_id (required).
get_tabsC
Get available tabs/navigation items for a course.
Args: course_id: Course ID
Returns: Dict with tab items showing available course sections
Inputs: course_id (required).
list_announcementsB
List announcements for one or more courses.
Args: course_ids: List of course IDs to fetch announcements for page: Page number (1-indexed) items_per_page: Number of items per page
Returns: PaginatedResponse containing announcements
Inputs: course_ids (required), page, items_per_page.
list_assignment_groupsC
List assignment groups for a course (shows grade weighting/categories).
Args: course_id: Course ID
Returns: Dict with assignment group items
Inputs: course_id (required).
list_assignmentsA
List assignments for a course.
Args: course_id: Course ID bucket: Bucket to filter assignments by (past, overdue, undated, ungraded, unsubmitted, upcoming, future) order_by: Field to order assignments by (due_at, position, name) include: Optional list of additional data to include (e.g., ["submission"] to see grade status) page: Page number (1-indexed) items_per_page: Number of items per page
Returns: PaginatedResponse containing assignments
Inputs: course_id (required), bucket (required), order_by (required), include, +2 more.
list_calendar_eventsB
List calendar events for courses.
Args: context_codes: List of context codes (e.g., ["course_4538"]) start_date: Optional start date in ISO 8601 format end_date: Optional end date in ISO 8601 format page: Page number (1-indexed) items_per_page: Number of items per page
Returns: PaginatedResponse containing calendar events
Inputs: context_codes (required), start_date, end_date, page, +1 more.
list_coursesA
List courses that the user is actively enrolled in.
Args: page: Page number (1-indexed) items_per_page: Number of items per page
Returns: PaginatedResponse containing courses
Inputs: page, items_per_page.
list_discussionsC
List discussion topics for a course.
Args: course_id: Course ID page: Page number (1-indexed) items_per_page: Number of items per page
Returns: PaginatedResponse containing discussion topics
Inputs: course_id (required), page, items_per_page.
list_favoritesA
List the current user's favorite courses.
Returns: Dict with favorite course items
Inputs: no named parameters.
list_filesA
List files for a course or folder.
Args: course_id: Optional Course ID folder_id: Optional Folder ID include: Optional list of additional data to include page: Page number (1-indexed) items_per_page: Number of items per page
Returns: PaginatedResponse[File]
Inputs: course_id, folder_id, include, page, +1 more.
list_planner_itemsB
List planner items for the authenticated user.
Args: start_date: start date in ISO 8601 format end_date: end date in ISO 8601 format context_codes: list of context codes (e.g., ["course_123"]) page: Page number (1-indexed) items_per_page: Number of items per page
Returns: PaginatedResponse[PlannerItem]
Inputs: start_date (required), end_date (required), context_codes, page, +1 more.
list_quizzesA
List quizzes for a course.
Args: course_id: Course ID include: Optional list of additional data to include page: Page number (1-indexed) items_per_page: Number of items per page
Returns: PaginatedResponse containing quizzes
Inputs: course_id (required), include, page, items_per_page.
list_submissionsA
List the current user's submissions for a course, including grades and feedback.
Args: course_id: Course ID include: Optional list of additional data (e.g., ["assignment", "submission_comments"]) page: Page number (1-indexed) items_per_page: Number of items per page
Returns: PaginatedResponse containing submissions with grades and comments
Inputs: course_id (required), include, page, items_per_page.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Every tool has a clearly distinct purpose based on the resource type and action (get_ vs list_). There is no ambiguity between tools as they each target a unique entity such as assignments, courses, files, quizzes, etc.
All tools follow a consistent verb_noun pattern: either get_<resource> for single items or list_<resource> for multiple items. The naming is predictable and easy to navigate.
22 tools is appropriate for an LMS that covers many entities like courses, assignments, modules, discussions, files, quizzes, pages, and more. Each tool serves a distinct purpose without overloading.
The server is clearly read-only, and within that scope it provides thorough coverage of major LMS entities (courses, assignments, modules, discussions, files, quizzes, pages, submissions, enrollments, calendar events, planner items). There are no obvious gaps for retrieving information.
Related MCP Connectors
Manage your Canvas coursework with quick access to courses, assignments, and grades. Track upcomin…
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Read-only access to Epivo's live course catalogue for AI agents.
Enables AI assistants to retrieve event data and execute event management operations in Nunify.
Related MCP Servers
- 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,565 npm14MIT
- FlicenseAqualityNot gradedmaintenanceEnables interaction with Canvas LMS courses and assignments directly from your LLM, allowing you to retrieve, search, and summarize course information, check due dates, and access assignment details without leaving your AI assistant.43,565 npm-
- AlicenseBqualityCmaintenanceEnables AI assistants to manage Canvas LMS courses, announcements, rubrics, assignments, modules, pages, and student data via the Canvas API.6032 npm12MIT
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Canvas courses and assignments through natural language, allowing retrieval, search, and summarization of course and assignment information.11-