UWaterloo MCP

Connect your UWaterloo Learn and Piazza accounts to Claude, ChatGPT, and Claude Code.

Read-only: reads course materials, announcements, grades, assignments, quizzes, and Piazza discussions. Never submits or posts.

Choose How to Run

Option 1: Deploy to Vercel (1-Click Cloud)

Best for Claude.ai and ChatGPT Web — provides a permanent HTTPS URL with zero server management or terminal commands.

1. Deploy to Vercel:

   

   When prompted, enter a secure MCP_AUTH_TOKEN (24+ characters). This is your server password.

2. Connect Private Blob Storage (required to keep your login session alive across serverless requests): In your Vercel project dashboard, go to Storage → Create Database → Blob, select Private, and click Connect to Project.

3. Sign in at /setup: Open https://<your-project>.vercel.app/setup in your browser. Enter your MCP_AUTH_TOKEN, log in to WatIAM with Duo, and optionally connect your Piazza account.

Option 2: Self-Host with Docker (Zero Vendor Lock-in)

Best for local use, Claude Desktop, or your own VPS / home server.

git clone https://github.com/syed-zayd/uwaterloo-mcp.git
cd uwaterloo-mcp
docker compose up -d

(Or without Docker: npm install && npm start — requires Node 22+ and Chrome)

Then open http://localhost:8787/setup in your browser to sign in.

Related MCP server: waterloo-learn-mcp

Connect Your AI Assistant

Once signed in at /setup, copy your ready-to-use config straight from the bottom of the page:

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "uwaterloo": {
      "url": "https://<your-project>.vercel.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_AUTH_TOKEN"
      }
    }
  }
}

(If running locally, use "url": "http://localhost:8787/mcp")

Claude Code CLI

claude mcp add uwaterloo https://<your-project>.vercel.app/mcp --header "Authorization: Bearer YOUR_MCP_AUTH_TOKEN"

ChatGPT & Claude.ai Web

In ChatGPT (Settings → Developer mode → Add MCP Server) or Claude.ai:

• Server URL: https://<your-project>.vercel.app/mcp

• Authentication: Bearer Token → paste your MCP_AUTH_TOKEN

(If self-hosting locally, expose your local port with a tunnel first: cloudflared tunnel --url http://localhost:8787)

Available Tools

Learn

• Courses & Upcoming: list_courses, get_upcoming, get_announcements, get_classlist, list_groups

• Grades & Rubrics: get_grades, get_rubric, get_rubric_definition

• Assignments & Submissions: list_assignments, get_submissions, get_submission_file, get_submission_file_url

• Course Content & Files: get_course_content, get_file, get_file_url, list_page_links, resolve_link

• Discussions & Quizzes: list_discussions, list_discussion_posts, get_discussion_thread, get_quiz_attempts

Piazza

• piazza_list_courses — List enrolled classes

• piazza_list_folders — List folders and categories

• piazza_search_posts — Search posts and instructor responses

• piazza_get_posts — Read full discussion threads

License

MIT