MCP Piazza
Read-only Piazza access: activity, search, unread posts, full threads, and course info
Connector by jadenpxrk · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/jadenpxrk-mcp-piazza
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.
- Tools
- 12 read · 0 write · 0 deleteRead-only
- Secrets
- 2 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Python package
Tools by what they do 12
Read from the source code; the running server may list different tools.
Read 12 · Look things up without changing anything.
get_attachmentget_course_infoget_course_statsget_postget_post_historyget_postsget_unread_countslist_courseslist_instructor_noteslist_postsrecent_activitysearch_posts
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
PIAZZA_COOKIE_FILEPIAZZA_PASSWORD
Other settings (environment variables or headers).
PIAZZA_ANONYMIZE_STUDENTSPIAZZA_CACHE_TTLPIAZZA_EMAILPIAZZA_FENCE_CONTENTPIAZZA_MIN_INTERVAL
Network hosts it talks to 2
github.com· found in codepiazza.com· found in code
Files it touches
~/.config/mcp-piazza/cookies.json- Any path the agent passes to its tools
Tools (12)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
get_attachmentread-onlyOpen a file or image that a post links to, such as an [image: ...] link or a piazza.com upload link. Images come back as images that the model can see. Text files come back as text. Other files, such as PDFs, come back as an embedded file if the client supports it. The maximum size is 10 MB.
get_course_inforead-onlyGet the course page: description, syllabus, office hours, general information, dates, and the staff list with names, roles and emails. Use it to find who teaches the course or when office hours are.
get_course_statsread-onlyGet the data from the course Statistics page. Some instructors hide this page from students.
get_postread-onlyRead one full thread: the question or note, both answers, and followups with replies. number is the post number that Piazza shows as @123.
get_post_historyread-onlyShow every version of a post, oldest first, with author and time. With diff=true, version 1 has the full text and each later version has only a diff from the version before. Use it to see what an instructor changed in an announcement or a question.
get_postsread-onlyRead up to 20 full threads from one course in one call. A post that cannot be read has an "error" field.
get_unread_countsread-onlyCount the posts with unread content in each course. Sends one request per course. By default only active courses are counted. Courses with no unread posts are left out.
list_coursesread-onlyList the user's Piazza courses with ID, course number, term, role, active status, and post folders. Other tools accept the ID, the course number, or part of the name. Set refresh=true to reload from Piazza.
list_instructor_notesread-onlyList notes and polls written by instructors, such as announcements and logistics, most recent first.
list_postsread-onlyList post summaries for a course, most recent activity first. filter: "unread" = posts with content the user has not read. "following" = posts the user follows. "unresolved" = unanswered questions and posts with unresolved followups. "unanswered" = questions with no answer. "mine" = the user's own posts that show their name. "starred" = posts the user starred. folder: only posts in this folder, for example "hw1". list_courses shows the folder names. Summaries have a short snippet only. Call get_post or get_posts for full threads.
recent_activityread-onlyList posts with new activity since a time, in all active courses or in one course. since: a relative age such as 24h, 7d or 2w, or an ISO date such as 2026-10-01. The default is 7d. Use this tool for questions such as "what did I miss this week". Courses without activity are left out.
search_postsread-onlySearch posts by keywords, like the Piazza search box, in one course or in all active courses. Use it before the user asks a new question, to find duplicates. Returns post summaries grouped by course.
Signals
- Stars
- 2
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 47
- Last commit
- Oct 16, 2026 (13 days ago)
- Last release
- Oct 16, 2026 (13 days ago)
- Last package publish
- Oct 16, 2026 (13 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.jadenpxrk/mcp-piazza- Version
- 0.1.0
- Auth
- API key
- Packages
- pypi mcp-piazza
- License
- MIT
- Repository
- github.com/jadenpxrk/mcp-piazza
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
MCP Piazza. Agent Mart. https://agentmart.dev/connectors/jadenpxrk-mcp-piazza (last updated 2026-10-24)