README.md
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
Tools 4
list_classesList active enrolled Piazza classesset_classSelect a class, get available folderssearch_postsSearch by keyword, folder, or bothget_postRead full post with answers and follow-upsEnvironment Variables
PIAZZA_EMAILrequiredYour Piazza login email addressPIAZZA_PASSWORDrequiredYour Piazza login passwordTry it
→List all the classes I am currently enrolled in on Piazza.
→Search for posts about 'midterm exam' in the 'General' folder of my current class.
→Get the full content and instructor answers for post number 42.
→Find recent discussions regarding the latest assignment in my CS101 class.