School MCP
@54yyyu
A Model Context Protocol (MCP) server for academic tools, integrating with Canvas and Gradescope platforms.
Overview
What is School MCP?
School MCP is a Model Context Protocol server that integrates academic tools with Canvas and Gradescope platforms, letting you fetch deadlines, manage files, and add events to macOS Calendar or Reminders.
How to use School MCP?
Install via Smithery (npx -y @smithery/cli install @54yyyu/school-mcp --client claude) or clone the repository and run pip install -e .. Use the setup_helper.py script for automatic Claude Desktop configuration, or manually set up a .env file. Run the server with python -m school_mcp or ./run_server.py.
Key features of School MCP
- Fetch upcoming assignment deadlines from Canvas and Gradescope
- Add deadlines to macOS Calendar or Reminders via AppleScript
- Download course materials from Canvas
- List all available Canvas courses
- Configure download path for file storage
- Check current download location
Use cases of School MCP
- Retrieve and view all upcoming assignments from both Canvas and Gradescope
- Automatically add homework deadlines to macOS Reminders
- Bulk download course files from Canvas
- Manage download storage locations per session
FAQ from School MCP
What platforms does School MCP integrate with?
School MCP integrates with the Canvas learning management system and the Gradescope grading platform.
How do I install School MCP?
You can install it via Smithery using the CLI command shown in the README, or by cloning the repository and running pip install -e ..
How do I configure School MCP for Claude Desktop?
Run the included setup_helper.py script, which finds your Claude Desktop configuration, creates a .env file, and adds the necessary environment variables. Manual configuration is also supported by editing a .env template and following the Claude Desktop Integration Guide.
Does School MCP require macOS for all features?
The calendar integration (adding to macOS Calendar or Reminders) uses AppleScript and is specific to macOS. Other features like fetching deadlines and file downloads do not explicitly require macOS.