Documentation Index
Fetch the complete documentation index at: https://docs.plaud.ai/llms.txt
Use this file to discover all available pages before exploring further.
Supported clients
| Client | Auto-configured | Restart after install |
|---|---|---|
| Claude Desktop | ✓ | ⌘Q + reopen |
| Claude Code | ✓ | Exit + new claude session |
| Codex Desktop | ✓ | Quit + reopen |
| Cursor / Windsurf / VS Code / Zed | ✓ | Reload per client UI |
| Claude Web / ChatGPT Web | Interactive guide | No restart needed |
Prerequisites
- Node.js ≥ 20 — download
- A Plaud account
Install
Run this once. The installer detects your AI clients, writes the MCP configuration, and opens your browser for sign-in:| Flag | What it does |
|---|---|
--yes | Auto-configure all detected local clients without prompts |
--no-login | Skip the browser sign-in step (useful on remote or headless machines) |
HTTP-based clients (Claude Web, ChatGPT Web)When connecting via HTTP, your recording data passes through Plaud’s MCP server (hosted in the US). Plaud does not store this data after the request completes — it is processed in transit only. Data handling is governed by Plaud’s privacy policy.
Claude Web
Open Integrations
Go to claude.ai, click your profile avatar in the top-right corner, and select Settings → Integrations.
Add the Plaud MCP server
Click Add integration. In the URL field, enter:Give it a name (e.g.
Plaud) and click Add.ChatGPT Web
Open Connectors
Go to chatgpt.com, click your profile avatar, and select Settings → Connectors.
Add a custom connector
Click Add connector → Model Context Protocol (MCP). In the server URL field, enter:Click Save.
Quick start
Once installed, sign in from your AI client:Log me into PlaudYour browser will open the Plaud authorization page. Click Authorize and return to your client — you’re signed in. Then try:
List my recent recordings
Summarize Tuesday’s standup
Draft a follow-up email from this meeting’s action items
Tools
These tools are available to your AI client once Plaud MCP is connected:| Tool | Description |
|---|---|
login | Opens your browser for OAuth sign-in |
logout | Signs out and revokes your authorization |
get_current_user | Shows your current account details |
list_files | Lists your recordings, with optional filters |
get_file | Returns full details for a single recording |
get_note | Returns the AI-generated summary, action items, and key topics |
get_transcript | Returns the full transcript with timestamps and speaker labels |
Filtering recordings with list_files
| Parameter | Description |
|---|---|
query | Case-insensitive keyword match on recording name |
date_from | Start date, YYYY-MM-DD |
date_to | End date, YYYY-MM-DD |
page / page_size | Pagination (ignored when filters are set) |
Skills
Skills are pre-built instructions that help your AI client handle common Plaud workflows automatically. They load when the installer runs — no extra steps needed.| Skill | Triggered when you ask things like… |
|---|---|
plaud-browse | ”list my recordings”, “show recent files” |
plaud-find | ”find the Weekly Sync”, “the meeting from Monday” |
plaud-read | ”show the transcript”, “summarize this recording” |
plaud-digest | ”weekly report”, “what meetings did I have this week” |
plaud-followup | ”draft a follow-up email”, “list the action items” |
plaud-export | ”save to Notion”, “post to Slack” |
Data reference
Fields returned by list_files and get_file
| Field | Type | Description |
|---|---|---|
id | string | Unique recording ID |
name | string | Recording name |
created_at | string | Creation time (ISO 8601) |
start_at | string | Recording start time (ISO 8601) |
duration | number | Duration in milliseconds |
serial_number | string | Device serial number |
Additional fields returned only by get_file
| Field | Type | Description |
|---|---|---|
presigned_url | string | Temporary audio download URL (valid 24 hours) |
source_list | array | Transcript segments with timestamps and speaker labels |
note_list | array | AI-generated notes in Markdown |
Upgrade
Uninstall
| Client | Cleanup command |
|---|---|
| Claude Desktop | plaud-mcp unsetup |
| Claude Code | claude mcp remove plaud --scope user && npx -y @plaud-ai/mcp clean-plugin |
| Codex Desktop | plaud-mcp unsetup codex |
Troubleshooting
| Symptom | Fix |
|---|---|
| Plaud tools don’t appear after install | Make sure you did a full client restart — closing and reopening the window is not enough. For Claude Code, exit and start a new claude session. |
401 / “Not authenticated” errors | Ask your AI client: “log me into Plaud”. |
No local clients configured in --yes mode | Install a supported local client first, or run without --yes to get interactive guidance for web clients. |
| Token refresh errors | Delete ~/.plaud/tokens-mcp.json and sign in again. |
| Browser doesn’t open during sign-in | Copy the URL the installer prints and open it manually. On remote machines, forward port 8199 first: ssh -L 8199:localhost:8199 user@host. |
| ”Server disconnected” in Claude Desktop | Re-run setup: plaud-mcp unsetup && plaud-mcp setup, then restart Claude Desktop. |
| Version didn’t update after upgrade | Run npx -y @plaud-ai/mcp clean-plugin, reinstall with /plugin install plaud in Claude Code, then restart. |