Piazza

This MCP server lets AI agents browse Piazza course forums by connecting to your Piazza account, enabling search across posts, reading questions and answers, and discovering relevant course content directly through your MCP client.

How to use

To use this Piazza MCP server, add it as an MCP server in your client and provide your Piazza login details when prompted. You can then list your enrolled classes, select a class to explore its folders, search posts by keyword or folder, and read full posts with answers.

How to install

Prerequisites you need before installing this server: a working MCP client, and the uv tool installed on your system.

Install uv if you do not have it. On macOS with Homebrew, run:

brew install uv

Choose one of the following methods to add the Piazza MCP server to your MCP client.

claude mcp add --scope user piazza --env PIAZZA_EMAIL=you@school.ca --env PIAZZA_PASSWORD=your-password -- uvx piazza-mcp@latest

Or configure in your MCP client using the provided JSON example as shown here.

{
  "mcp": {
    "servers": {
      "piazza": {
        "command": "uvx",
        "args": ["piazza-mcp@latest"],
        "env": {
          "PIAZZA_EMAIL": "you@school.ca",
          "PIAZZA_PASSWORD": "your-password"
        }
      }
    }
  }
}

Additional setup and notes

Credentials required are your Piazza login email and password. Use the same credentials you use to access Piazza.

Additional configuration and development tips

The project also demonstrates an alternative local development approach using your MCP client to run a local clone. You can clone the repository, sync with your development group, and run the server from a local path.

git clone https://github.com/smchase/piazza-mcp
cd piazza-mcp
uv sync --group dev

If you prefer to run the server from a local directory using your MCP client, you can point the client to your local clone with the following configuration.

claude mcp add piazza-dev --env PIAZZA_EMAIL=you@school.ca --env PIAZZA_PASSWORD=your-password -- uv --directory /path/to/piazza-mcp run piazza-mcp

Security and credentials

Always protect your Piazza credentials. Use environment variable injection in your MCP client configurations and avoid sharing these values publicly.

Available tools

list_classes

List active enrolled Piazza classes for easy navigation and selection.

set_class

Set the active class by its network ID and retrieve available folders for that class.

search_posts

Search posts by keywords and/or folders with optional limits to refine results.

get_post

Read a full post including its questions, answers, and follow-ups.