mcpField
S
School MCP

School MCP

Local
github.com/54yyyuScience & Education8Updated 5w ago
Repository

About School MCP

School MCP is an academic MCP server for Canvas and Gradescope, with a companion CLI for coursework tasks. It helps students check deadlines, manage course files, and work with course information.

Key features

  1. 01Fetch Canvas and Gradescope deadlines
  2. 02Add deadlines to macOS Reminders
  3. 03List Canvas courses
  4. 04Download Canvas course files
  5. 05CLI for announcements, inbox, and grades

Use cases

  1. 01Review upcoming coursework deadlines
  2. 02Save assignments to macOS Reminders
  3. 03Download and compare course materials
  4. 04Check announcements, messages, and grades

MCP support

Exposes academic tools to MCP clients, including deadline lookup, reminders, course listing, and Canvas file downloads.

#canvas#mcp#claude#gradescope

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "school": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

School MCP

smithery badge

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
  1. Clone the repository:
git clone https://github.com/yourusername/school-mcp.git
cd school-mcp
  1. Install the package:
pip install -e .
  1. 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:

  1. Copy the environment template:
cp .env.template .env
# Edit .env with your credentials
  1. 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

CLI: cw / coursework

pip install -e . also installs a command-line tool, cw (long name coursework):

cw deadlines                 # unsubmitted work due in the next 14 days (Canvas + Gradescope)
cw deadlines -s canvas -d 7  # Canvas only, next week
cw announcements -u          # unread course announcements
cw inbox -u                  # unread Canvas inbox conversations
cw message 512758            # read a thread (does not mark it read)
cw grades 20.201             # per-assignment scores for one course
cw files 6.7810 --compare ~/Desktop/MIT/6.7810 --missing   # what's not filed locally yet
cw download crispr           # download a course's files (or --id ID ... for a selection)
cw use columbia              # switch the active account

Courses can be named by code, name fragment or Canvas id. Every command has -h, --json, and (where it talks to a school) -a ACCOUNT.

A Claude Code skill for the CLI lives in skill/coursework/; symlink it into ~/.claude/skills/ to make it available in every session.

MCP 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:

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

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.