Canvas LMS MCP Server (Cloudflare Workers)

Remote MCP server that connects to Canvas LMS and exposes course/assignment/quiz tools over Cloudflare Workers.

What this server provides

The MCP agent is served at:

GET /mcp (MCP endpoint)

It currently implements these tools:

get_active_courses: Returns active courses filtered to course names containing SP or FL.
get_assignments: Returns assignments due in the next n days (1-90, default 7).
get_quizzes: Returns quizzes due in the next n days (1-90, default 7).

Prerequisites

Node.js 18+ (or newer)
npm
A Cloudflare account
A Canvas LMS access token and base URL (for example https://sjsu.instructure.com)

Install

npm install

Configure environment variables

Use local vars for development by creating/updating .dev.vars:

CANVAS_BASE_URL=https://your-school.instructure.com
CANVAS_TOKEN=your_canvas_token

For deployment, use Wrangler secrets instead of committing credentials:

wrangler secret put CANVAS_TOKEN
wrangler secret put CANVAS_BASE_URL

Run locally

npm run dev

Default local URL:

http://localhost:8787/mcp

Health check route:

http://localhost:8787/

Deploy

npm run deploy

After deploy, your MCP endpoint is:

https://<your-worker>.<your-subdomain>.workers.dev/mcp

Use with an MCP client (example: Claude Desktop via mcp-remote)

Add/update your MCP client config:

{
  "mcpServers": {
    "canvas": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<your-worker>.<your-subdomain>.workers.dev/mcp"
      ]
    }
  }
}

For local testing:

{
  "mcpServers": {
    "canvas": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:8787/mcp"]
    }
  }
}

Useful scripts

npm run dev: Start local Worker development server.
npm run deploy: Deploy to Cloudflare Workers.
npm run type-check: Run TypeScript type checking.
npm run lint:fix: Auto-fix lint issues via oxlint.
npm run format: Format repo with oxfmt.
npm run cf-typegen: Regenerate Wrangler type bindings.

Project structure

src/index.ts: MCP server definition and tool implementations.
src/lib/helper.ts: Canvas pagination (Link header parsing).
public/: Static assets for Worker static asset binding.
wrangler.jsonc: Cloudflare Worker configuration.

Canvas LMS MCP Server