Skip to main content
Glama
UWaterloo MCP

UWaterloo MCP

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:

    Deploy with 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers