Skip to main content
Glama
Canvas LMS MCP Server

Canvas LMS MCP Server

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 claude

Prerequisites

  • Python 3.13+

  • Canvas LMS API token

  • uv package manager (recommended)

Installation Methods

The easiest way to install and run canvas-lms-mcp is using uvx:

uvx canvas-lms-mcp

This will run the server in an isolated environment without installing it permanently.

To install the tool permanently:

uv tool install canvas-lms-mcp

Option 2: Install from Source

  1. Clone the repository:

    git clone https://github.com/yourusername/canvas-lms-mcp.git
    cd canvas-lms-mcp
  2. Install 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.com

You 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.py

If installed with uvx tool:

canvas-lms-mcp

By 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 ID

  • include (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 ID

  • include (optional): List of additional data to include

  • per_page (optional, default=100): Number of items per page

get_module_items

Get items for a specific module.

Parameters:

  • course_id (required): Course ID

  • module_id (required): Module ID

Assignments

list_assignments

List assignments for a course.

Parameters:

  • course_id (required): Course ID

  • bucket (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 ID

  • assignment_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 ID

  • page_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 ID

  • include (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 IDs

  • page (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 ID

  • page (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 ID

  • discussion_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 format

  • end_date (optional): End date in ISO 8601 format

  • page (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 format

  • end_date (required): End date in ISO 8601 format

  • context_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 ID

  • include (optional): List of additional data to include

  • page (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 ID

  • quiz_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 ID

  • folder_id (optional): Folder ID

  • include (optional): List of additional data to include

  • page (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 ID

  • file_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.json

  • Windows: %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 tools
get_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

    A3.6/5.0

    Scored across 22 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    Related MCP Servers