[!TIP] Want it on your phone, on the web, or across several computers? Go to the 🌐 Remote Edition →. It has the same 209 tools, served over a password-protected ngrok tunnel with automatic failover between computers.

🤔 Local or Remote?

✨ Highlights

• 📊 Grade intelligence: what_if_grade, compute_needed_score, grade_impact_ranking, full weighted breakdowns
• 📅 Planning: get_week_ahead, semester_snapshot, study_priority_ranking, cross-course missing work in one call
• 📝 Submissions: submit text, URLs and files, with a dry-run preview first
• 💬 Discussions & inbox: read whole threads in one request and message instructors
• 📁 Content: files, pages, modules, lecture captions and full .imscc course export

🧭 How it works

 Your AI app (MCP client)      ──stdio──►  node index.js  ──HTTPS──►  your school's Canvas API
        (starts the server)              (209 tools, runs only
                                          while your app is open)

No web server, no ports, nothing to keep running. Your AI app starts the server when it opens and stops it when it closes.

🚀 Quick start

You need: Node.js 18+ and a Canvas account. There's nothing to download yourself: your AI app fetches the server with npx.

1. Create a Canvas access token

In Canvas, go to Account → Settings → Approved Integrations → + New Access Token. Canvas only shows the token once, so copy it right away. Student tokens usually expire after 30–120 days.

2. Add it to your AI app

npx -y canvas-lms-mcp-local

3. Try it

Ask your assistant: "Run test_connection." It checks your identity, courses, planner, inbox and missing submissions, and reports any features your school has disabled.

Then try: "What's due this week?", "What do I need on the final to get a B?" or "Which missing assignments hurt my grade the most?"

git clone https://github.com/Fireiscoolsolo/canvas-lms-mcp-local.git
cd canvas-lms-mcp-local
npm install

{ "mcpServers": { "canvas": { "command": "node", "args": ["C:/Users/YOUR-NAME/Documents/canvas-lms-mcp-local/index.js"] } } }

⚙️ Configuration

Put settings in the env block of your config, as in step 2. If you run from source, you can use .env next to index.js instead.

🧰 Tools

🔐 Security

• Nothing is exposed: the server doesn't listen on any port. Only the app that started it can talk to it, through a private pipe.
• Confirmation gate: tools that send, submit, post or delete return a preview first and only act when called with confirm: true.
• Prompt-injection fencing: text other people wrote is wrapped in <<<CANVAS_CONTENT>>> markers and labelled as untrusted.
• No quiz-taking: quiz attempt endpoints are deliberately not included.

Never commit .env. It's already listed in .gitignore. See SECURITY.md.

🎓 Responsible use

This is a study and organization tool. It helps you see deadlines, understand your grades and plan your week. It never takes quizzes, and nothing is sent or submitted until you've seen a preview and confirmed it.

• Follow your school's academic integrity and acceptable-use policies. Some schools restrict personal API tokens or third-party tools.
• Want zero risk of accidental changes? Set CANVAS_ALLOW_WRITES=false for read-only mode.

🛠️ Troubleshooting

Known limits: a student token can't reach admin endpoints, gradebook history, course analytics or quiz statistics. smart_search is a Canvas beta feature and often returns 404.

📄 License

MIT. This project isn't affiliated with Instructure.