MCP Piazza
Read-only Piazza access: unread posts, search, full threads and course info for students
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- today
Similar MCP servers
About MCP Piazza
MCP Piazza is an open-source MCP server for education and exams. It runs locally on your machine and is started by your AI client.
mcp-piazza lets an assistant answer questions about your university Piazza courses. Twelve tools list courses, read the course page with syllabus and office hours, count unread posts, show recent activity since a time, list or search posts with filters like unresolved, unanswered or starred, read one or up to 20 full threads, show a post's version history, list instructor notes, open attachments and read course statistics.
It adds three prompts, catch_up, before_asking and exam_prep, plus matching skills. Piazza has no public API, so the server logs in the way the website does through the piazza-api library, using browser sessions, a login page, cookies or a password. Only session cookies are saved, with file mode 600.
It cannot post, edit, endorse or delete. Post text is fenced as untrusted to resist prompt injection, student names can be replaced with pseudonyms, and requests are throttled. Reading a full post marks it read, as on the website. It is not affiliated with Piazza.
Install
Run in a terminal
claude mcp add mcp-piazza --env PIAZZA_PASSWORD='<PIAZZA_PASSWORD>' -- uvx mcp-piazzaAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-piazza": {
"command": "uvx",
"args": [
"mcp-piazza"
],
"env": {
"PIAZZA_PASSWORD": "<PIAZZA_PASSWORD>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-piazza": {
"command": "uvx",
"args": [
"mcp-piazza"
],
"env": {
"PIAZZA_PASSWORD": "<PIAZZA_PASSWORD>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-piazza": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-piazza"
],
"env": {
"PIAZZA_PASSWORD": "<PIAZZA_PASSWORD>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-piazza": {
"command": "uvx",
"args": [
"mcp-piazza"
],
"env": {
"PIAZZA_PASSWORD": "<PIAZZA_PASSWORD>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-piazza": {
"command": "uvx",
"args": [
"mcp-piazza"
],
"env": {
"PIAZZA_PASSWORD": "<PIAZZA_PASSWORD>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIAZZA_EMAILPiazza account email. Not needed after 'mcp-piazza login'.PIAZZA_PASSWORDPiazza account password. Not needed after 'mcp-piazza login'.PIAZZA_COOKIE_FILEPath of the saved session file.PIAZZA_ANONYMIZE_STUDENTSReplace student names with pseudonyms.PIAZZA_FENCE_CONTENTMark post text as untrusted data.PIAZZA_MIN_INTERVALMinimum seconds between Piazza requests.PIAZZA_CACHE_TTLSeconds to keep feeds and posts in memory.
Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- list_courses
- List your courses.
- get_course_info
- Get the course page, syllabus and staff.
- get_unread_counts
- Count unread posts per course.
- recent_activity
- List posts with new activity since a time.
- list_posts
- List posts with filters.
- search_posts
- Search posts by keyword.
- get_post
- Read one full thread.
- get_posts
- Read up to 20 full threads.
- get_post_history
- Show a post's versions with diffs.
- list_instructor_notes
- List instructor notes and polls.
- get_attachment
- Open an attachment.
- get_course_stats
- Get course statistics.
What it does
- Catch-up summaries
- See what changed in your courses since a given time.
- Search and filters
- Find unresolved, unanswered or starred posts.
- Full threads
- Read questions, answers and follow-ups together.
- Course info
- Syllabus, office hours and staff.
- Prompt-injection fencing
- Marks post text as untrusted data.
- Student pseudonyms
- Optionally hide other students' names.
Good for
- Summarise what I missed on Piazza this week
- Check whether a question was already asked
- Collect facts about an upcoming exam
- Look up TA office hours
Pricing
Open source
MCP Piazza FAQ
Can it post to Piazza?
No, it is read-only and cannot post, edit, endorse or delete.
How does it log in?
Through browser session, login page, password or cookie; only cookies are saved.
Does it need an API key?
No, Piazza has no public API, so it logs in as the website does.
Is MCP Piazza free?
Yes. MCP Piazza is open source, so you can use and self-host it for free.
How do I add MCP Piazza to Claude Code?
Run this command in your terminal: claude mcp add mcp-piazza --env PIAZZA_PASSWORD='<PIAZZA_PASSWORD>' -- uvx mcp-piazza
What are the best alternatives to MCP Piazza?
The closest alternatives to MCP Piazza are Penline Handwriting Sheets, Lumen, Education Mcp, Born Then and FreeDict.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.