Skip to main content
Glama
@rishblob/canvas-mcp-server

@rishblob/canvas-mcp-server

by risnake

@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 >=18

  • Canvas API token

Related MCP server: mcp-server-canvas-lms

Environment variables

  • CANVAS_API_TOKEN required: Canvas bearer token for API authentication.

  • CANVAS_BASE_URL optional: 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 start

For one-shot local development:

npm run dev

Use as a published npm package

npx -y @rishblob/canvas-mcp-server
# or
bunx @rishblob/canvas-mcp-server

MCP 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"
      }
    }
  }
}
{
  "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_settings

  • Assignments/submissions: list_assignments, get_assignment, create_assignment, update_assignment, list_submissions, get_submission, grade_submission

  • Users: get_user_profile, get_user, list_course_users

  • Announcements: list_announcements, create_announcement

  • Modules: list_modules, get_module, list_module_items

  • Discussions: list_discussions, get_discussion, create_discussion, list_discussion_entries

  • Calendar: list_calendar_events, create_calendar_event

  • Files: list_files, get_file, list_folders

  • Pages: list_pages, get_page, create_page, update_page

  • Enrollments: list_enrollments, get_user_enrollments

  • Conversations: list_conversations, get_conversation, create_conversation

  • Misc: list_todo_items, search_courses, get_course_activity_stream

Publish to npm

npm login
npm publish

prepack runs npm run build, so package artifacts are built automatically before publish.

Available Tools

40 tools
create_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

    B3/5.0

    Scored across 40 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers