@audividi/mcp

AudiVidi's MCP server — read your transcripts from Claude, Cursor, Windsurf, Zed, Claude Code and other MCP clients. Read-only. Two ways to run it:

| | Hosted (no install) | Local (stdio) | |---|---|---| | URL / command | https://audividi.ai/api/mcp | npx -y @audividi/mcp@latest | | Auth | Authorization: Bearer av_... header | AUDIVIDI_API_KEY env or the login tool | | Works with | Claude Code, Cursor, Windsurf, VS Code, Claude.ai (Team/Enterprise admins) | Claude Desktop and every stdio client |

Create a key in AudiVidi → Settings → Developers (starts with av_, shown once). Full guide with copy-ready snippets: https://audividi.ai/developers

Hosted — Claude Code

claude mcp add --transport http audividi https://audividi.ai/api/mcp --header "Authorization: Bearer av_YOUR_KEY"

Hosted — Cursor / Windsurf (mcp.json)

{ "mcpServers": { "audividi": { "url": "https://audividi.ai/api/mcp", "headers": { "Authorization": "Bearer av_YOUR_KEY" } } } }

Local — Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "audividi": {
      "command": "npx",
      "args": ["-y", "@audividi/mcp@latest"],
      "env": { "AUDIVIDI_API_KEY": "av_YOUR_KEY" }
    }
  }
}

Requires Node 20+. Optional AUDIVIDI_API_URL overrides the base URL (default https://audividi.ai).

Tools (all read-only)

| Tool | What it does | Hosted | Local | |------|--------------|:-:|:-:| | login | Sign in with an av_ API key (saved to ~/.config/audividi/credentials.json, mode 0600). | | x | | logout | Remove the locally stored key. | | x | | get_current_user | Show the signed-in account. | x | x | | list_files | List your transcripts; filter by keyword, since_days, page. | x | x | | search_files | Keyword search within a from/to date window (YYYY-MM-DD). | x | x | | get_transcript | Full transcript: text + timestamped segments with speaker labels. | x | x | | get_note | AI note: summary, action items, key topics. | x | x | | get_file | Metadata + audio download URL (when stored) + segments + note. | x | x | | export_transcript | Transcript as txt/srt/vtt/json/md, or the summary as txt/md/json. | x | x | | ask_library | Ask a question across your indexed library; answer + citations, honest low-confidence state. | x | x |

Scope & guarantees

• Read-only. No record/edit/delete tool; the key carries read scope only.
• Tools see the transcripts stored on the server. Enable Library Sync (Settings → Advanced) to make your library reachable.
• Rate limit: 60 requests per minute per key. A hosted MCP tool call counts once for the MCP request and once for the endpoint it reads, so budget about 30 tool calls per minute.

Develop

npm install
npm test      # vitest
npm run build # tsc → dist/

Changelog: CHANGELOG.md. License: MIT.