mcp-piazza

A read-only Model Context Protocol server for Piazza. It works with every MCP client: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Zed, Cline, Codex, Gemini CLI, Goose, opencode, JetBrains, LM Studio, Continue, and others.

Ask your assistant about your courses:

• "What did I miss on Piazza this week?"
• "Are there unresolved questions about HW3 in CSE 12?"
• "Did anyone already ask about the midterm room?"
• "When are the TA office hours?"
• "What did the instructor change in @142?"

The server only reads data. It cannot post, edit, endorse, or delete.

Quick start

1. Install uv.

2. Log in one time. The command opens a login page in your browser:

   uvx mcp-piazza login
   

   You can also skip this step. If the server has no session, the first tool call opens the same page and shows its link.

3. Add the server to your client. The server command is uvx with the argument mcp-piazza. For example:

   claude mcp add --scope user --transport stdio piazza -- uvx mcp-piazza   # Claude Code
   codex mcp add piazza -- uvx mcp-piazza                                   # Codex CLI
   

   See docs/clients.md for Claude Desktop, Cursor, VS Code, Windsurf, Zed, Gemini CLI, and other clients.

4. Ask: "List my Piazza courses."

Tools, prompts and resources

Every tool accepts a course ID, a course number such as CSE 12 or cse12, or part of the course name.

Many clients show prompts as slash commands.

Skills work in Claude Code, Cursor, Codex, opencode, and other agents. They need the server. To install them:

npx skills add jadenpxrk/mcp-piazza

See docs/tools.md for parameters and output fields, and docs/workflows.md for examples.

Authentication

Piazza has no public API. This server uses piazza-api, which logs in as the Piazza website does.

All methods save only the session cookies to ~/.config/mcp-piazza/cookies.json with file mode 600. They do not save your password. When the session expires, the next tool call opens the login page again. mcp-piazza logout deletes the session.

Configuration

See docs/configuration.md for examples and the command line.

Privacy and safety

• Read-only. The server has no tools that change Piazza data. The only write is the optional PIAZZA_KEEP_UNREAD restore.
• Prompt-injection fencing. Other course members write the post text. The server puts that text between <<<UNTRUSTED PIAZZA TEXT ...>>> markers, and the server instructions tell the model to treat it as data.
• Student pseudonyms. When PIAZZA_ANONYMIZE_STUDENTS=true, other students show as Student 3f2a1c. Staff keep their names. Your own posts show as you.
• Local only. The server runs on your computer. It sends your cookies only to piazza.com.

See docs/privacy.md for the full model and its limits.

Development

uv sync
uv run pytest               # offline tests, no Piazza account needed
uv run ruff check src tests
uv run ruff format src tests
uv run mypy src

See AGENTS.md for the project layout and rules.

Limitations

• Piazza can change its internal API at any time. If tools fail after a Piazza update, see docs/troubleshooting.md.
• When the server reads a full post, Piazza marks the post as read and counts a view, as the website does. Set PIAZZA_KEEP_UNREAD=true to mark unread posts unread again.
• The course page files and links (the Resources tab) are not available. get_course_info shows the names of the resource sections only.
• Piazza does not document the poll format. get_post returns the poll data as Piazza sends it.
• Some instructors hide the Statistics page. For those courses, get_course_stats returns an error.

License

MIT. This project is not affiliated with Piazza.