# MCP Piazza

> MCP Piazza is an open-source MCP server for education and exams. Read-only Piazza access: unread posts, search, full threads and course info for students. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/jadenpxrk/mcp-piazza
- **MCP Registry name:** io.github.jadenpxrk/mcp-piazza
- **Categories:** [education and exams](https://ai-powered.com/categories/education-and-exams)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-piazza --env PIAZZA_PASSWORD='<PIAZZA_PASSWORD>' -- uvx mcp-piazza
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-piazza": {
      "command": "uvx",
      "args": [
        "mcp-piazza"
      ],
      "env": {
        "PIAZZA_PASSWORD": "<PIAZZA_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-piazza": {
      "command": "uvx",
      "args": [
        "mcp-piazza"
      ],
      "env": {
        "PIAZZA_PASSWORD": "<PIAZZA_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-piazza": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-piazza"
      ],
      "env": {
        "PIAZZA_PASSWORD": "<PIAZZA_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-piazza": {
      "command": "uvx",
      "args": [
        "mcp-piazza"
      ],
      "env": {
        "PIAZZA_PASSWORD": "<PIAZZA_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-piazza": {
      "command": "uvx",
      "args": [
        "mcp-piazza"
      ],
      "env": {
        "PIAZZA_PASSWORD": "<PIAZZA_PASSWORD>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [Penline Handwriting Sheets](https://ai-powered.com/mcp/penline-handwriting-sheets): Penline Handwriting Sheets is an MCP server for education and exams.
- [Lumen](https://ai-powered.com/mcp/lumen-4): Lumen is an open-source MCP server for education and exams.
- [Education Mcp](https://ai-powered.com/mcp/education-mcp): Education Mcp is a freemium MCP server for education and exams.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [FreeDict](https://ai-powered.com/mcp/freedict): FreeDict is a freemium MCP server for language learning.
- [Extraudinary](https://ai-powered.com/mcp/extraudinary): Extraudinary is a freemium MCP server for education and exams.
- [Scormbusters](https://ai-powered.com/mcp/scormbusters): Scormbusters is an MCP server for education and exams.
- [Dengdeng Chinese Dictionary](https://ai-powered.com/mcp/dengdeng-chinese-dictionary): Dengdeng Chinese Dictionary is a free MCP server for language learning.

---
Source: https://ai-powered.com/mcp/mcp-piazza
