plaud-mpm-plugin/README.md

plaud-mpm-plugin

Connects Claude to Plaud recordings — list, search, transcripts, summaries, and AI notes directly in CoWork.

Version: 0.1.0 Author: Message Point Media Repo: https://git.alwisp.com/jason/plaud-mpm-plugin CoWork Project: CW-012 — Plaud MCP Plugin

---

Overview

This CoWork plugin gives Claude direct access to Bryan's Plaud voice recordings via the unofficial Plaud API. It authenticates using a bearer token stored in ~/.plaud/config.json (written by the plaud-connector import-token command) and exposes 7 MCP tools covering listing, searching, transcripts, summaries, and AI-generated notes. The plugin runs as a Python FastMCP stdio server launched by uv — no additional runtime dependencies beyond mcp[cli].

Authentication

Token is read from ~/.plaud/config.json → token.token field (plaud-connector format). Falls back to PLAUD_TOKEN environment variable.

Token setup (one-time):

npx tsx ~/Developer/plaud-connector/packages/cli/bin/plaud.ts import-token app "<jwt>"

Get the JWT from Chrome DevTools → Network → any api.plaud.ai request → Authorization: Bearer <token>. Tokens last ~300 days. Re-run import-token when expired.

MCP Tools (7)

Tool	Description
plaud_list_recordings	List all recordings newest-first. Params: limit, only_with_transcript.
plaud_search_recordings	Filter by title_contains, start_date, end_date, only_with_transcript.
plaud_get_transcript	Full transcript text for a recording ID.
plaud_get_summary	AI-generated summary for a recording ID.
plaud_get_notes	AI notes and action items (content_list) for a recording ID.
plaud_get_recording_detail	Full metadata: title, date, duration, flags, language, device, tags.
plaud_user_info	Account info and connection status.

Skills

Skill	Trigger phrases
plaud	"pull the transcript", "what was discussed in my last meeting", "search my Plaud recordings", "show me action items from [meeting]", "meeting transcript", "meeting summary", "voice notes"

Dependencies

• mcp[cli] (via uv run --with mcp[cli]) — FastMCP server framework
• plaud-connector (external, for auth setup only) — https://github.com/rggnkmp/plaud-connector
• Python stdlib only for HTTP (urllib.request)

Region

US region (api.plaud.ai). Set PLAUD_REGION=eu env var to switch to EU (api.plaud.eu).

File Structure

plaud-mpm-plugin/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata
├── .mcp.json                # MCP server config (uv + plaud_mcp.py)
├── server/
│   └── plaud_mcp.py         # FastMCP server — 7 tools
├── skills/
│   └── plaud/
│       └── SKILL.md         # Skill definition and workflow guidance
└── README.md