Skip to main content
Glama

Plaud MCP Server

MCP server for Plaud transcripts via CDP proxy through the running Plaud Desktop app.

How It Works

Claude Code → MCP Server → CDP (WebSocket) → Plaud Desktop → Plaud API

The MCP connects to the running Plaud Desktop Electron app via Chrome DevTools Protocol:

  1. Sends SIGUSR1 to the Plaud Desktop process to enable Node.js inspector (port 9229)

  2. Connects via WebSocket to the inspector

  3. Executes API calls through the app's own authenticated $fetch function

  4. Returns results back through MCP tools

No token extraction, no cookies, no API keys. Uses the app's live authenticated session directly.

Related MCP server: Plaud Notes MCP Server

Prerequisites

  1. Plaud Desktop - installed and signed in

  2. Python 3.10+

  3. uv (recommended)

Installation

# Install as a CLI tool (recommended)
uv tool install "plaud-mcp @ git+https://github.com/davidlinjiahao/plaud-mcp"

# Or install from local source
uv tool install --force "plaud-mcp @ ."

Configuration

Add to ~/.claude.json:

{
  "mcpServers": {
    "plaud": {
      "command": "${HOME}/.local/bin/plaud-mcp",
      "args": [],
      "env": {}
    }
  }
}

No API keys or tokens needed. Just ensure Plaud Desktop is running.

MCP Tools

Tool

Description

check_connection

Verify Plaud Desktop is available

get_file_count

Total number of recordings

get_recent_files

Files from the last N days

get_files

Files with optional date filters

get_file

Metadata for a specific file

get_transcript

Full transcript with speaker labels

get_summary

AI-generated summary

search_transcripts

Search transcripts by content

Troubleshooting

"Plaud Desktop is not running"

Launch the Plaud Desktop app and sign in.

"Could not enable inspector"

The SIGUSR1 signal may have failed. Ensure Plaud Desktop is the main process, not a helper.

Search is slow

search_transcripts fetches and searches client-side. Reduce the days parameter.

Why CDP?

Plaud's API validates auth at the Chromium network stack level - tokens extracted from LevelDB don't work with standard HTTP clients (httpx, curl, curl_cffi with Chrome impersonation all return 401). The CDP approach bypasses this entirely by executing requests through the app's own authenticated context.

Development

uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
ruff check src/ && pyright src/

Available Tools

8 tools
check_connectionA

Check if Plaud Desktop is available and authenticated.

Inputs: no named parameters. Returns: object

get_fileB

Get metadata for a specific Plaud file.

Inputs: file_id (required). Returns: object

get_file_countA

Get the total number of Plaud files.

Inputs: no named parameters. Returns: object

get_filesB

Get Plaud files with optional date filters (ISO format, e.g. '2024-01-01').

Inputs: start_date, end_date, limit. Returns: result

get_recent_filesB

Get Plaud files from the last N days.

Inputs: days. Returns: result

get_summaryB

Get AI-generated summary for a Plaud file.

Inputs: file_id (required). Returns: object

get_transcriptB

Get full transcript with speaker labels for a Plaud file.

Inputs: file_id (required). Returns: object

search_transcriptsC

Search recent transcripts for matching content. Searches client-side.

Inputs: query (required), days. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools have distinct purposes: connection check, file retrieval variants, summary, transcript, and search. However, 'get_files' and 'get_recent_files' could cause slight confusion as both retrieve files but with different filtering.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, such as 'check_connection', 'get_file', 'search_transcripts'. The naming is predictable and easy to understand.

    Tool Count5/5

    With 8 tools, the server is well-scoped for its purpose of interacting with Plaud files. Each tool provides distinct functionality without redundancy or excessive complexity.

    Completeness3/5

    The tool set covers retrieval (files, summaries, transcripts) and search, but lacks any create, update, or delete operations. This leaves a notable gap for file management, though it may be intentional due to API limitations.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • Your Plaud recordings in natural language: list recordings, read speaker-attributed transcripts and

      https://api.mcp.ai/p_plaud
    • Fathom MCP server for ChatGPT, Claude and any AI agent: list calls, complete action item, add action item, share call, set link access, regenerate summary, update settings and delete call in your own Fathom account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Fathom yourself; Cotlet does not store your password and you need no Fathom API key. About the official Fathom API: Fathom has a REST API and an official MCP server, but both only read your calls (checked 22 Oct 2026). The API lists meetings and returns summaries, transcripts and action items, requests recording downloads and manages webhooks. Setup and FAQ: https://cotlet.dev/integrations/fathom-video-api-mcp-server

    • Otter.ai MCP server for ChatGPT, Claude and any AI agent: search transcripts, export transcript, share conversation, add highlight, upload audio and list action items in your own Otter.ai account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Otter.ai yourself; Cotlet does not store your password and you need no Otter.ai API key. About the official Otter.ai API: Yes, but narrowly (checked 16 Oct 2026). Otter.ai has an official hosted MCP server with three tools (user info, search, fetch) that only read, and a public REST API available to Enterprise workspaces that reads conversations, transcripts, action items, insights, outlines, audio, channels and the workspace, and imports a recording from a file URL. Setup and FAQ: https://cotlet.dev/integrations/otter-api-mcp-server

      https://cotlet.dev/mcp/v1/otter
    • Bluedot MCP server for ChatGPT, Claude and any AI agent: list meetings, search transcripts, get meeting summary and transcript, move meeting to collection, create collection, create notes template, apply notes template and add comment in your own Bluedot account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Bluedot yourself; Cotlet does not store your password and you need no Bluedot API key. About the official Bluedot API: Bluedot documents no REST API, but it has an official MCP server and webhooks (checked 20 Oct 2026). The MCP server has 8 tools that only read meetings, transcripts, summaries, collections and participants, and the pricing page lists it from the Basic plan. Setup and FAQ: https://cotlet.dev/integrations/bluedot-api-mcp-server

      https://cotlet.dev/mcp/v1/bluedot

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to access Plaud Note recordings, providing direct access to speaker-diarized transcripts and AI-generated meeting summaries. Users can search, list, and retrieve recording details directly within MCP-compatible clients like Claude and Cursor.
      1
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables read-only, natural-language access to Plaud recordings, including listing recordings, retrieving speaker-attributed transcripts, AI-generated summaries, action items, and user data through MCP tools.
      MIT