Canvas MCP
Provides read-only access to a student's Canvas account: courses, current grades, per-assignment grades and details, missing work, upcoming due dates, syllabus, modules, announcements, and quizzes.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
canvas mcp
lets claude see your canvas. you ask it stuff like "what am i missing?" or "what's my grade in chem?" and it checks canvas for you, from your phone or computer, even when your own pc is off.
it can only look. it can't submit, edit, or delete anything in canvas. and only the github account(s) you pick can use it, so nobody else can see your grades.
it runs for free on cloudflare (the free plan is way more than enough).
what you need
a canvas login (your school's canvas, like
yourschool.instructure.com)a github account (free, it's just used to sign in)
a cloudflare account (free, make one at dash.cloudflare.com)
a claude.ai account that can add custom connectors
a computer with node.js installed (nodejs.org, the LTS one) for the setup. after setup you don't need the computer anymore
it takes about 20 minutes the first time.
Related MCP server: canvas-scholar-mcp
easiest way: let an ai do it
if you have claude code (or another coding agent):
download this repo and open the folder in claude code
say: "set this up for me, follow AGENTS.md"
it does everything it can by itself. it'll stop and ask you when it needs you, which is only for:
logging into cloudflare (a browser tab opens, you click allow)
making a github "oauth app" (a form with 3 boxes, it tells you exactly what to type)
pasting 3 secret codes into a box it opens for you (it never sees them)
clicking "approve" and "authorize" once at the end to test it
that's it. skip to add it to claude when it says it's done.
doing it yourself
open a terminal in this folder (on windows: shift + right click the folder → "open in terminal").
1. install stuff
npm install2. log into cloudflare
npx wrangler logina browser tab opens. log in and click allow. if it says "timed out", log into dash.cloudflare.com in your browser first, then run it again.
3. run setup
change the two values to yours:
node scripts/setup.mjs init --canvas-url https://yourschool.instructure.com --github-user your-github-name--canvas-urlis the address you see when you open canvas in a browser, just the start of it, no slashes at the end--github-useris your github username (not your email)
if it says your cloudflare account has no "workers.dev subdomain", run it again with --subdomain somename added at the end. pick anything, it becomes part of your server's address.
when it finishes it prints your server address and 3 lines for the next step. keep that window open.
4. make the github sign-in app
go to github.com/settings/applications/new and fill in exactly what setup printed:
application name:
Canvas MCPhomepage url: your server address (setup printed it)
authorization callback url: your server address +
/callback(setup printed it)leave "enable device flow" unchecked
click register application. on the next page:
you'll see the client id. copy it, you need it in step 5
click generate a new client secret. copy it right away, github only shows it once
5. save the 3 secrets
run each of these and paste when it asks. what you paste is hidden, that's normal.
node scripts/set-secret.mjs GITHUB_CLIENT_ID
node scripts/set-secret.mjs GITHUB_CLIENT_SECRET
node scripts/set-secret.mjs CANVAS_API_TOKENfor the canvas token: in canvas go to account → settings, scroll to approved integrations, click + new access token, type Claude as the purpose, click generate token, and copy the long code it shows (about 70 characters, has a ~ in it). canvas only shows it once.
the script checks the canvas token with canvas before saving it, so if you pasted the wrong thing it tells you.
(on windows you can also use powershell -File set-secret.ps1 CANVAS_API_TOKEN, which opens a little box instead.)
6. put it online
node scripts/setup.mjs deployit uploads it and checks it's working. it prints the url to use in claude.
add it to claude
do this once, on the claude.ai website on a computer. your phone picks it up automatically.
claude.ai → settings → connectors → add custom connector
name:
Canvas. url: your server address with/mcpon the end (deploy printed it)if it shows more options: pick sign in now, register automatically, and streamable http. leave headers empty
click add / connect
a "Canvas MCP" page opens → click approve
github asks to authorize → click authorize
then in any chat (phone too), open the tools / + menu and make sure Canvas is turned on. try "what's due this week?"
if something breaks
"canvas token is invalid or expired": your canvas token ran out or got deleted. make a new one (step 5) with
node scripts/set-secret.mjs CANVAS_API_TOKEN. no need to redeploy or reconnectgithub says "this server is private": you signed in with a github account that isn't on the list. use the one you gave setup, or rerun
initwith the right--github-userand thendeployconnector won't connect: check the url ends in
/mcp. runnode scripts/setup.mjs statusto see what's missing"final grade" looks way too low: that's canvas counting every assignment that isn't graded yet as a zero. "current" is the one that matches what you see in canvas
what it can see
courses and current grades, grades per assignment, assignment details, missing work, what's due soon, syllabus, modules, announcements, quizzes.
it does not do files, messages, or anything that changes canvas.
good to know
the canvas token is as powerful as your canvas password. this server only ever reads with it, but don't share it. if you think it leaked, delete it in canvas → settings
your secrets live in your cloudflare account only, not in this folder and not on github
the
wrangler.jsoncfile setup makes has your school and username in it. it's ignored by git on purpose, don't upload it
built on cloudflare's remote mcp github oauth template. mit license.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage your Canvas coursework with quick access to courses, assignments, and grades. Track upcomin…
Study from your own classes: synced Canvas coursework, notes, flashcards and study progress.
1Ask any GitHub repository a question. Get source-backed answers.
Read your plat.plus courses, tasks, course pages, sessions, files and messages. Read-only.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides read-only access to Canvas LMS, enabling users to view active courses, grades, and upcoming assignments through natural language queries.2MIT
- AlicenseAqualityBmaintenanceEnables students to ask an AI assistant about their Canvas LMS data, including assignments, grades, missing submissions, discussions, and upcoming items, while keeping access read-only and private.43MIT
- AlicenseNot gradedqualityBmaintenanceEnables natural-language queries across multiple schools' Canvas and Blackboard accounts for courses, notifications, assignments, grades, feedback, and schedules, with read-only access and local todo/calendar export.9MIT
- AlicenseNot gradedqualityAmaintenanceEnables students, instructors, and account administrators to interact with Canvas LMS through natural language for course, assignment, enrollment, grade, user, reporting, and account administration tasks via the Canvas LMS API.21 npmMIT