piazza-mcp
An MCP server that lets AI agents browse your Piazza course forums — search posts, read questions/answers, and discover relevant course content.
Install
Requires uv (brew install uv).
Claude Code
claude mcp add --scope user piazza --env PIAZZA_EMAIL=you@school.ca --env PIAZZA_PASSWORD=your-password -- uvx piazza-mcp@latest
VS Code
Add to .vscode/mcp.json:
{
"mcp": {
"servers": {
"piazza": {
"command": "uvx",
"args": ["piazza-mcp@latest"],
"env": {
"PIAZZA_EMAIL": "you@school.ca",
"PIAZZA_PASSWORD": "your-password"
}
}
}
}
}
Credentials are your Piazza login email and password.
Tools
| Tool | Description |
|---|---|
list_classes() | List active enrolled Piazza classes |
set_class(network_id) | Select a class, get available folders |
search_posts(query, folder, limit) | Search by keyword, folder, or both |
get_post(post_number) | Read full post with answers and follow-ups |
Development
git clone https://github.com/smchase/piazza-mcp
cd piazza-mcp
uv sync --group dev
Use a local clone in your MCP client:
claude mcp add piazza-dev --env PIAZZA_EMAIL=you@school.ca --env PIAZZA_PASSWORD=your-password -- uv --directory /path/to/piazza-mcp run piazza-mcp