# 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
1. Clone or download this repository
2. Create a virtual environment and install dependencies:
```bash
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:
1. Log in to Piazza in your browser
2. Navigate to the course you want to add
3. Look at the URL - it will look like: `https://piazza.com/class/abc123xyz`
4. 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:
```json
{
"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:**
```json
{
"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:**
```json
{
"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:
```bash
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?"
