Canvas MCP Server
Provides tools for interacting with the Canvas LMS API, allowing users to list courses and filter them by enrollment type (teacher, student, or TA).
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 courses where I'm a student"
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
A Model Context Protocol (MCP) server implementation for the Canvas LMS API. This server provides functionality to interact with Canvas LMS programmatically.
Features
List courses from Canvas LMS with optional enrollment type filtering
Interactive help prompts for using the tools
Related MCP server: canvas-mcp
Prerequisites
Node.js 18 or later
A Canvas LMS instance
Canvas API access token
Cursor (for client integration)
Setup
Clone this repository
Install dependencies:
npm installSet up environment variables:
export CANVAS_BASE_URL="https://your-canvas-instance.com" export CANVAS_ACCESS_TOKEN="your-api-token"Build the project:
npm run buildStart the server:
npm start
Connecting with Cursor
To use this MCP server with Cursor:
Open Cursor's settings
Navigate to the MCP configuration section
Add a new server configuration:
{ "mcpServers": { "canvas": { "command": "npm", "args": [ "start" ], "cwd": "/path/to/mcp-server-canvas" } } }Save the configuration and restart Cursor
The Canvas tools will now be available in Cursor's MCP tools panel
Available Tools
list_courses
Lists all courses from Canvas LMS.
Parameters:
enrollment_type(optional): Filter courses by enrollment type (teacher, student, ta)
Example response:
{
"content": [
{
"type": "text",
"text": [
{
"id": 1234,
"name": "Example Course",
"code": "EX101",
"state": "available",
"startDate": "2024-01-01T00:00:00Z",
"endDate": "2024-12-31T23:59:59Z"
}
]
}
]
}list-courses-help
An interactive prompt that provides help with using the list_courses tool.
Development
The server is built using TypeScript and the MCP SDK. To add new features:
Add new API methods to the
CanvasAPIclassRegister new tools using
server.tool()Register help prompts using
server.prompt()Build and test your changes
Troubleshooting
If you encounter issues:
Check that environment variables are set correctly
Verify your Canvas API token has the necessary permissions
Check Cursor's MCP server logs for any error messages
Ensure the server path in Cursor's configuration is correct
License
MIT
Available Tools
1 toolget_user_coursesC
Get courses for a specific user with optional grading count
Inputs: user_id (required), include_grading_count, enrollment_state.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The tool has a clear, specific purpose focused on retrieving user courses, leaving no ambiguity for an agent to misselect.
The single tool name follows a consistent verb_noun pattern (get_user_courses), making it predictable and readable. There are no other tools to compare against, so no inconsistency can arise.
One tool is too few for a server named 'Canvas MCP Server', which suggests a broader educational platform scope (e.g., courses, assignments, grades). This minimal set severely limits functionality and feels incomplete for the implied domain.
The tool surface is severely incomplete for a Canvas server, covering only user course retrieval. There are obvious gaps: no CRUD operations for courses, assignments, submissions, or grades, and no ability to create, update, or delete resources, which will cause significant agent failures.
Maintenance
Related MCP Connectors
Model Context Protocol server for Studex tools, notifications, and profile integrations
Run the Geduk LMS from an AI assistant: courses, sessions, enrolments, users and catalogue.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Create, validate, edit, export (markdown/svg/png/mermaid), and search JSON Canvas files.
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables interaction with the Canvas Learning Management System API, allowing users to manage courses, assignments, enrollments, and grades within Canvas.543,565 npm104JavaScriptMIT
- AlicenseCqualityCmaintenanceLocal-first MCP server for Canvas LMS. Stdio transport, no third-party broker, token stays in ~/.canvas.env. Exposes courses, assignments, modules, announcements, grades, planner items, upcoming events, todo list, and bulk file dump as MCP tools.1049 PyPI4MIT
- AlicenseNot gradedqualityDmaintenanceEnables managing Canvas LMS courses, assignments, grades, modules, and more from MCP-compatible clients like Claude Desktop, Kiro, or Amazon Q Developer.MIT
- AlicenseNot gradedqualityAmaintenanceEnables students, instructors, and account administrators to interact with Canvas LMS through natural language, covering course and module navigation, assignment submission and grading, quizzes, discussions, announcements, grades, files, and account-level user, course, and reporting administration. It supports both stdio and streamable HTTP transports with automatic retries, pagination, and a broad set of Canvas API tools.21 npmMIT