# Plaud MCP Server

Connect your [Plaud Note](https://www.plaud.ai) recordings directly to Claude, Cursor, or any MCP-compatible AI client. Search, retrieve, and work with your meeting transcripts and AI summaries hands-free.

## What It Does

This MCP server gives your AI assistant direct access to your Plaud recordings:

- **List recordings** — See all your recordings with dates, durations, and transcript status
- **Get transcripts** — Pull full speaker-diarized transcripts for any recording
- **Get AI summaries** — Retrieve Plaud's AI-generated meeting summaries
- **Search** — Find recordings by title/keyword
- **Get recent** — Quickly pull your most recent recordings with full transcripts

## Setup (5 minutes)

### 1. Install dependencies

```bash
git clone https://github.com/YOUR_USERNAME/plaud-mcp.git
cd plaud-mcp
pip install -r requirements.txt
```

### 2. Get your Plaud auth token

Plaud doesn't offer public API keys, so you'll grab your session token from the web app:

1. Open [web.plaud.ai](https://web.plaud.ai) in Chrome
2. Sign in to your account
3. Open DevTools: `Cmd+Option+J` (Mac) or `Ctrl+Shift+J` (Windows)
4. Click the **Network** tab
5. Refresh the page
6. Click any request to `api.plaud.ai`
7. In the request headers, find `Authorization: Bearer eyJ...`
8. Copy everything after `Bearer ` — that's your token

### 3. Configure your token

```bash
cp .env.example .env
```

Open `.env` and paste your token:

```
PLAUD_TOKEN=eyJhbGciOiJSUzI1NiIs...your_full_token_here
```

### 4. Connect to your AI client

#### Claude Code
```bash
claude mcp add plaud -- python /path/to/plaud-mcp/server.py
```

#### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "plaud": {
      "command": "python",
      "args": ["/path/to/plaud-mcp/server.py"],
      "env": {
        "PLAUD_TOKEN": "your_token_here"
      }
    }
  }
}
```

#### Cursor / Windsurf / Other MCP Clients
Follow the same pattern — point to `server.py` as the command with your token as an env var.

### 5. Test it

Ask your AI: *"List my recent Plaud recordings"* or *"What did I discuss in my last meeting?"*

## Token Refresh

Plaud tokens expire periodically. When you get auth errors, just repeat step 2 to grab a fresh token and update your `.env` file.

## Available Tools

| Tool | Description |
|------|-------------|
| `plaud_verify_token` | Check if your auth token is valid |
| `plaud_list_recordings` | List recordings with pagination |
| `plaud_get_transcript` | Get full transcript + AI summary for a recording |
| `plaud_search_recordings` | Search recordings by title keyword |
| `plaud_get_recent` | Get recent recordings with full transcripts |

## Privacy

- This runs **100% locally on your machine**
- Your Plaud token never leaves your computer
- No data is sent to any third party
- Only you can access your recordings through this server

## License

MIT — use it however you want.