Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/smchase/piazza-mcp
cd piazza-mcpThen follow the repository README for any remaining dependency or build steps.
Add it to Claude Code
Paste the maintainer's config below, then edit any placeholder values.
{
"mcp": {
"servers": {
"piazza": {
"command": "uvx",
"args": [
"piazza-mcp@latest"
],
"env": {
"PIAZZA_EMAIL": "[email protected]",
"PIAZZA_PASSWORD": "your-password"
}
}
}
}
}See the piazza-mcp README for full setup instructions.
PIAZZA_EMAILPIAZZA_PASSWORDMake your agent remember this setup
piazza-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- List active enrolled Piazza classes
- Search posts by keywords or specific folders
- Retrieve full discussion threads including answers and follow-ups
- Select specific course networks for targeted searching
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
Original README from smchase/piazza-mcp
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 [email protected] --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": "[email protected]",
"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 [email protected] --env PIAZZA_PASSWORD=your-password -- uv --directory /path/to/piazza-mcp run piazza-mcp