https://github.com/aryankeluskar/canvas-mcp
Collection of Canvas LMS and Gradescope tools for the ultimate EdTech model context protocol. Allows you to query your courses, find resources, and chat with upcoming assignments in the AI app of your choice. try now!
https://github.com/aryankeluskar/canvas-mcp
anthropic canvas mcp python uv
Last synced: 2 months ago
JSON representation
Collection of Canvas LMS and Gradescope tools for the ultimate EdTech model context protocol. Allows you to query your courses, find resources, and chat with upcoming assignments in the AI app of your choice. try now!
- Host: GitHub
- URL: https://github.com/aryankeluskar/canvas-mcp
- Owner: aryankeluskar
- License: mit
- Created: 2025-03-20T06:17:08.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-04-14T23:17:29.000Z (2 months ago)
- Last Synced: 2025-04-16T00:57:29.966Z (2 months ago)
- Topics: anthropic, canvas, mcp, python, uv
- Language: Python
- Homepage: https://git.new/canvas-mcp
- Size: 4.92 MB
- Stars: 6
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - Canvas MCP - Interact with Canvas LMS and Gradescope to query courses and assignments, retrieve resources, and check submission statuses using natural language. Provides tools for finding relevant course materials and managing upcoming assignments. (Education and Learning)
README
# Canvas MCP
[](https://smithery.ai/server/@aryankeluskar/canvas-mcp)
Canvas MCP is a set of tools that allows your AI agents to interact with Canvas LMS and Gradescope.
## Features
- **Find relevant resources** - Ability to find relevant resources for a given query in natural language!
- **Query upcoming assignments** - Not only fetch upcoming assignments, but also provide its breakdown for a given course.
- **Get courses and assignments from Gradescope** - Query your Gradescope courses and assignments with natural language, get submission status, and more!
- Get courses
- Get modules
- Get module items
- Get file url
- Get calendar events
- Get assignments
- and so much more...
## Usage
Note down the following beforehand:
1. Canvas API Key from `Canvas > Account > Settings > Approved Integrations > New Access Token`
2. Gemini API key from https://aistudio.google.com/app/apikey
3. Gradescope Email and Password https://www.gradescope.com/
### Installing via Smithery (**Preferred**)
To install Canvas MCP for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@aryankeluskar/canvas-mcp):
```bash
npx -y @smithery/cli install @aryankeluskar/canvas-mcp --client claude
```
Or, for Cursor IDE to use canvas-mcp with other models:
```bash
npx -y @smithery/cli install @aryankeluskar/canvas-mcp --client cursor
```
Or, for Windsurf:
```bash
npx -y @smithery/cli install @aryankeluskar/canvas-mcp --client windsurf
```
---
### Manual Installation (ONLY for local instances)
Download the repository and run the following commands:
```bash
git clone https://github.com/aryankeluskar/canvas-mcp.git
cd canvas-mcp
# Install dependencies with uv (recommended)
pip install uv
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt
# Or install with pip
pip install -r requirements.txt
```
### Manual Configuration
Create a `.env` file in the root directory with the following environment variables:
```
CANVAS_API_KEY=your_canvas_api_key
GEMINI_API_KEY=your_gemini_api_key
```
Add the following to your `mcp.json` or `claude_desktop_config.json` file:
```json
{
"mcpServers": {
"canvas": {
"command": "uv",
"args": [
"--directory",
"/Users/aryank/Developer/canvas-mcp",
"run",
"canvas.py"
]
}
}
}
```
---
Built by [Aryan Keluskar](https://aryankeluskar.com) :)