Skip to content
MCP server

MCP Piazza

Read-only Piazza access: unread posts, search, full threads and course info for students

Runs locallyStatus and history
Install
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-piazza

Add 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.

How AIPoweredBot checks servers