Skip to main content
Glama

Canvas Study

Canvas Study connects an AI assistant such as Claude to your own Canvas courses so it can help you study: quizzing you on course material, scheduling reviews so you remember it, planning your week around deadlines, and helping you learn from feedback on graded work.

It is built to help you learn, not to do your work for you.

This is an early version, shared for feedback. If something breaks or feels wrong, please open an issue.

What It Does

  • Review that sticks. Save questions about what you are learning, and Canvas Study schedules each one to come back just before you would forget it. You answer first, then see the reference answer, then say how well you recalled it.

  • Planning. See what is due and overdue across all your courses, alongside the reviews coming up, and work out a plan that starts early instead of the night before.

  • Course material. The assistant can read your course pages, modules, and syllabus so it can quiz you on what your course actually covers.

  • Feedback. It can read scores, instructor comments, and rubric results on your graded work to help you see what to practice next.

Related MCP server: Canvas MCP Server

What It Will Not Do

  • It cannot change anything in Canvas. It can only read. It cannot submit assignments, take quizzes, or post to discussions.

  • It is not for writing your assignments. The assistant is instructed to help you understand and practice, and to leave graded work to you. Your course's own rules on AI use come first: check your syllabus, and ask your instructor if you are unsure.

Privacy

  • It runs on your computer. There is no Canvas Study server, and nobody running this project ever sees your token or your data.

  • Your access token works like a password for everything you can see in Canvas. Keep it private, set an expiry date when you create it, and delete it in Canvas if you stop using this.

  • What the assistant reads goes to your AI provider. When it reads a course page or your grades, that content is sent to the company behind your assistant, as with anything else you share with it.

  • Your review questions and history are kept in a file on your computer, in a folder named .canvas-study-mcp in your home folder.

Install

Step 1: Create a Canvas Access Token

  1. In Canvas, click Account, then Settings.

  2. Under Approved Integrations, click New Access Token.

  3. Enter a purpose such as "Canvas Study", choose an expiry date, and generate the token.

  4. Copy the token now. Canvas will not show it again.

Some schools do not let students create tokens. If you do not see the button, this tool will not work at your school.

Step 2: Add It to Your Assistant

Claude Desktop (no terminal needed)

  1. Download canvas-study.mcpb from the latest release.

  2. Open the file. Claude Desktop shows a Canvas Study page: click Install, then Install again to confirm.

  3. Enter your school's Canvas address (such as canvas.illinois.edu), paste your token, and click Save, then Save again to confirm.

  4. Turn on the switch at the bottom left of that page so it reads Enabled. It starts out disabled.

  5. Start a new chat. The first time Claude uses a Canvas Study tool, it asks your permission.

Claude Code

claude mcp add canvas-study \
  --env CANVAS_BASE_URL=canvas.illinois.edu \
  --env CANVAS_API_TOKEN=your-token \
  -- npx -y canvas-study-mcp

Other MCP clients

You need Node.js 20 or newer. Add this to your client's MCP configuration:

{
  "mcpServers": {
    "canvas-study": {
      "command": "npx",
      "args": ["-y", "canvas-study-mcp"],
      "env": {
        "CANVAS_BASE_URL": "canvas.illinois.edu",
        "CANVAS_API_TOKEN": "your-token"
      }
    }
  }
}

Getting Started

Once it is installed, try asking your assistant:

  • "What do I have due in the next two weeks? Help me plan."

  • "Quiz me on this week's material in my algorithms course."

  • "Help me write review questions about recursion, then save them."

  • "What reviews do I have due today?"

  • "Look at the feedback on my last few assignments. What should I work on?"

A few minutes of review most days works far better than one long session before an exam.

Tools

Tool

Purpose

list_courses

Active courses and current scores

get_upcoming_work

Upcoming and overdue work, plus the review load for each day

get_assignment

Instructions, rubric, and submission status for one assignment

get_feedback

Recently graded work with comments and rubric results

list_course_materials

Modules and their items

read_course_page

Text of a course page

get_syllabus

Course syllabus, including any policy on AI use

add_review_items

Save question-and-answer items to the review schedule

get_due_reviews

Prompts due for review now, without answers

attempt_review

Record your answer and reveal the reference answer

rate_review

Schedule the next review from your recall rating

list_review_items, update_review_item, delete_review_item

Manage saved items

get_review_stats

Review load, recent activity, and most-forgotten items

Review scheduling uses FSRS. Set CANVAS_STUDY_DATA_DIR to keep review data somewhere else.

Limits

  • It reads Canvas pages, assignments, modules, and the syllabus. It does not yet read uploaded files such as PDFs and slides, or quiz questions.

  • It only sees what is in Canvas. Courses that keep material elsewhere will look empty.

  • The assistant is guided, not locked down: this tool shapes what it can see and do in Canvas, but how you use an AI assistant is still up to you.

Development

npm install
npm run check      # typecheck, test, build
npm run pack:mcpb  # build canvas-study.mcpb for Claude Desktop

Testing Against a Local Canvas

scripts/seed-local-canvas.mjs seeds a local development Canvas (it refuses any address that is not .localhost) with a test course: a syllabus with an AI policy, pages in a module, a rubric, and graded, overdue, and upcoming assignments. It needs an admin token, existing teacher and student users, and the student's password, then logs in as the student to create an access token and prints the environment for the server:

CANVAS_ADMIN_TOKEN=... CANVAS_STUDENT_PASSWORD=... NODE_EXTRA_CA_CERTS="$(mkcert -CAROOT)/rootCA.pem" \
  node scripts/seed-local-canvas.mjs --canvas-url=https://canvas.example.localhost > .env

If the local Canvas uses an mkcert certificate, the server also needs NODE_EXTRA_CA_CERTS set to the mkcert root.

License

MIT

Available Tools

15 tools
add_review_itemsAdd Review ItemsA

Saves question-and-answer items to the student's spaced-review schedule, stored only on their computer. Prefer items the student wrote in their own words; draft items yourself only when asked, and show them to the student first. A good item covers one idea, asks why or how rather than for a bare definition, and can be answered in a sentence or two. New items are due right away.

Inputs: items (required), course_id, course_name.

attempt_reviewAttempt ReviewA

Records the student's own answer to a review prompt and returns the reference answer. Pass what the student actually said, word for word, including 'I don't know'. Never invent or improve their answer. Then compare the two for them honestly and ask them to rate their recall with rate_review.

Inputs: item_id (required), student_answer (required).

delete_review_itemDelete Review ItemA
Destructive

Permanently removes a review item and its history. Confirm with the student first.

Inputs: item_id (required).

get_assignmentGet AssignmentA
Read-only

Reads one assignment: instructions, rubric, due date, and the student's submission status. Use it to help the student understand what is being asked and what the rubric rewards. If the assignment is still open, help them plan and learn the underlying material; the work itself is theirs to write.

Inputs: course_id (required), assignment_id (required).

get_due_reviewsGet Due ReviewsA
Read-only

Returns the review items due now, most overdue first, with prompts only. Ask the student one prompt at a time and wait for their own answer. Do not answer for them or hint at the answer; then call attempt_review with what they said.

Inputs: limit, course_id.

get_feedbackGet FeedbackA
Read-only

Returns the student's recently graded work in a course with scores, instructor comments, and rubric results. Use it to find patterns in what went wrong and turn them into specific things to practice or review.

Inputs: course_id (required), limit.

get_review_statsGet Review StatsB
Read-only

Summarizes the student's spaced review: how much is due, the next week's load, activity by topic, and the items they forget most often. Use the weak items to decide what to re-study or re-teach, not just re-quiz.

Inputs: course_id.

get_syllabusGet SyllabusA
Read-only

Reads a course's syllabus. Check it for the course's policy on AI use and collaboration before helping with graded work, and follow that policy.

Inputs: course_id (required).

get_upcoming_workGet Upcoming WorkA
Read-only

Shows what is due soon across courses, what is overdue and unsubmitted, and how many spaced-review items come due each day. Use it to help the student plan backwards from deadlines: spread work across the available days, start large items early, and leave time for reviews.

Inputs: days, course_id.

list_course_materialsList Course MaterialsA
Read-only

Lists a course's modules and the items in each (pages, assignments, files, links). Use it to find the material for a topic the student wants to study, then read pages with read_course_page.

Inputs: course_id (required).

list_coursesList CoursesA
Read-only

Lists the student's active Canvas courses with their current score in each. Start here to get course IDs.

Inputs: no named parameters.

list_review_itemsList Review ItemsA
Read-only

Lists saved review items with their schedule, without answers, so browsing the list does not spoil retrieval practice. Set include_answers only when the student wants to edit or check an item.

Inputs: topic, course_id, include_answers.

rate_reviewRate ReviewA

Schedules the next review of an item from the student's rating of their recall. The student chooses the rating; if their answer was wrong or missing it must be 'again'. Requires attempt_review first.

Inputs: rating (required), item_id (required).

read_course_pageRead Course PageC
Read-only

Reads the text of a Canvas course page. When studying from it, quiz the student on the ideas rather than summarizing the page for them: recalling is what builds memory.

Inputs: page_url (required), course_id (required).

update_review_itemUpdate Review ItemA

Edits a saved review item's topic, prompt, answer, or source. Its review schedule is kept.

Inputs: item_id (required), topic, answer, prompt, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 15 tools

    Disambiguation4/5

    The set splits cleanly into a Canvas course-reading group and a spaced-review group, and within each the tools target distinct resources (list_courses vs get_syllabus vs get_assignment vs get_feedback are clearly separable). The only real overlap is that get_upcoming_work also reports how many review items come due per day, which slightly crosses into get_due_reviews/get_review_stats territory, and get_due_reviews vs list_review_items vs get_review_stats require reading descriptions closely to keep apart.

    Naming Consistency5/5

    Every tool is a snake_case verb_noun pairing (list_courses, get_assignment, add_review_items, rate_review, delete_review_item), and the verb family is applied semantically: list_ for collections, get_/read_ for single entities or content, and the mutation verbs (add/update/delete/attempt/rate) for review lifecycle actions.

    Tool Count5/5

    At 15 tools the surface is dual-purpose (course inspection + spaced-review management) yet stays within a well-scoped range, with each tool covering a distinct action rather than duplicating another.

    Completeness4/5

    The review system has full lifecycle coverage (create, list, attempt, rate, update, delete, stats) and the course side covers courses, syllabus, materials, pages, assignments, deadlines, and feedback. Minor gaps remain: there is no direct way to enumerate all assignments for a course (only upcoming/overdue items or module listings), and grading/submission actions are deliberately out of scope.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers