School MCP

Verified

3

Overview InspectNew Schema Related Servers Reviews Score

Need Help?View Source Code Report Issue

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Fetches upcoming assignment deadlines, lists available courses, and downloads course materials and files
Adds deadlines to macOS Calendar or Reminders using AppleScript and manages local file downloads

School MCP

A Model Context Protocol (MCP) server for academic tools, integrating with Canvas and Gradescope platforms.

Features

Assignment Deadlines: Fetch and display upcoming deadlines from Canvas and Gradescope
Calendar Integration: Add deadlines to macOS Calendar or Reminders using AppleScript
File Management: Download course materials from Canvas

Quickstart

Installation

Installing via Smithery

To install School MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @54yyyu/school-mcp --client claude

Clone the repository:

git clone https://github.com/yourusername/school-mcp.git
cd school-mcp

Install the package:

pip install -e .

Set up your environment variables by either:
- Using the included setup helper (recommended)
- Creating a .env file manually

Using the Setup Helper

Run the setup helper to configure Claude Desktop automatically:

python setup_helper.py

The setup helper will:

Find your Claude Desktop configuration file
Create a .env file if needed
Configure the MCP server with proper paths
Add your environment variables to the Claude Desktop configuration

Manual Setup

If you prefer to set up manually:

Copy the environment template:

cp .env.template .env
# Edit .env with your credentials

Configure Claude Desktop by following the Claude Desktop Integration Guide.

Running the server

Run directly:

python -m school_mcp

Or use the convenience script:

./run_server.py

Tools

get_deadlines: Fetch upcoming assignment deadlines from Canvas and Gradescope
add_to_reminders: Add assignments to macOS Reminders
list_courses: List all available Canvas courses
download_course_files: Download files from a Canvas course
set_download_path: Configure where downloaded files are saved
get_download_path_info: Check the current download location

Configuration

The server tries to find configuration in this order:

Environment variables
.env file in the current directory
Existing config.json file in the home directory

License

MIT

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

A Model Context Protocol server that helps students manage academic workflows by integrating with Canvas and Gradescope to fetch deadlines, download course materials, and sync with macOS Calendar or Reminders.