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