Piazza MCP Server

An MCP (Model Context Protocol) server that allows Claude Code to interact with Piazza, enabling you to fetch posts and course information directly from your terminal.

Prerequisites

Python 3.10+
A Piazza account
Claude Code CLI

Installation

Clone or download this repository

Create a virtual environment and install dependencies:

python -m venv env

# Windows
env\Scripts\activate

# macOS/Linux
source env/bin/activate

pip install -r requirements.txt

Configuration

Getting Your Course IDs

To find a course ID:

Log in to Piazza in your browser
Navigate to the course you want to add
Look at the URL - it will look like: https://piazza.com/class/abc123xyz
The course ID is the part after /class/ (e.g., abc123xyz)

Setting Up Claude Code

Create or edit the .mcp.json file in your project directory:

{
  "mcpServers": {
    "piazza": {
      "command": "/path/to/your/env/bin/python",
      "args": ["/path/to/piazza-mcp/main.py"],
      "env": {
        "PIAZZA_EMAIL": "your-email@example.com",
        "PIAZZA_PASSWORD": "your-piazza-password",
        "PIAZZA_COURSES": "{\"course_id_1\":\"Course Name 1\",\"course_id_2\":\"Course Name 2\"}"
      }
    }
  }
}

Windows example:

{
  "mcpServers": {
    "piazza": {
      "command": "C:\\path\\to\\env\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\piazza-mcp\\main.py"],
      "env": {
        "PIAZZA_EMAIL": "student@university.edu",
        "PIAZZA_PASSWORD": "yourpassword",
        "PIAZZA_COURSES": "{\"mjz1kp056nb6t3\":\"CSE 12\",\"mk06sxvpt521xv\":\"ECON 1\"}"
      }
    }
  }
}

macOS/Linux example:

{
  "mcpServers": {
    "piazza": {
      "command": "/home/user/piazza-mcp/env/bin/python",
      "args": ["/home/user/piazza-mcp/main.py"],
      "env": {
        "PIAZZA_EMAIL": "student@university.edu",
        "PIAZZA_PASSWORD": "yourpassword",
        "PIAZZA_COURSES": "{\"mjz1kp056nb6t3\":\"CSE 12\",\"mk06sxvpt521xv\":\"ECON 1\"}"
      }
    }
  }
}

Environment Variables

| Variable | Description | |----------|-------------| | PIAZZA_EMAIL | Your Piazza account email | | PIAZZA_PASSWORD | Your Piazza account password | | PIAZZA_COURSES | JSON object mapping course IDs to course names |

Available Tools

Once configured, Claude Code will have access to these tools:

`list_courses`

Returns the list of configured courses.

Example usage in Claude Code:

"What courses do I have configured?"
"List my Piazza courses"

`fetch_posts`

Fetches recent posts from a specified course.

Parameters:

course_id (required): The Piazza course ID
n (optional): Number of posts to fetch (default: 10)

Example usage in Claude Code:

"Show me the last 5 posts from CSE 12"
"What are the recent questions on ECON 1?"
"Check the latest 3 posts on my physics class"

Usage Examples

After configuration, simply start Claude Code in a directory with the .mcp.json file:

claude

Then you can ask natural language questions like:

"What are my Piazza courses?"
"Show me the last 3 posts on ECON 1"
"Are there any new questions about the midterm in CSE 12?"
"What's the latest instructor answer on PHYS 2A?"

MCP Servers