# Spoken

Hands your agent Markdown transcripts of published podcasts, with the actual names of the people talking. Useful when you need an episode's text and would rather skip the audio.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: spokenmd
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/spokenmd/spoken
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/mcp/spoken

## What it does

Spoken is an API for pulling transcripts of podcasts that are already out. Nothing gets uploaded, no diarization runs on your side: the service fills in real speaker names in place of anonymous labels, adds timestamps, and returns Markdown shaped for LLM context and RAG chunking.

The local build ships as `spoken-mcp` and runs through `npx`; the hosted one lives at `https://spoken.md/mcp`. Either way you get eight tools: search episodes by text or a pasted Spotify/YouTube link, list a show's catalog, fetch a transcript, check credits, follow shows, and see new episodes. A key goes in `SPOKEN_API_KEY`. Leave it out and the demo key `pt_demo` takes over — search and episode listing stay fully usable, while transcripts stop at the demo episode.

Credits are pay-per-use, no subscription attached. Fetching the same transcript again costs nothing, and failed calls are not billed. Keeping a knowledge base fresh comes down to calling `list_new_episodes` on a schedule and then `get_transcript` on whatever it returns.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://spoken.md/mcp`
- Environment variables: `SPOKEN_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http spoken https://spoken.md/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env SPOKEN_API_KEY=<SPOKEN_API_KEY> --transport stdio spoken -- npx -y spoken-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add spoken --url https://spoken.md/mcp
```

2. **Platform CLI**
```bash
codex mcp add spoken --env SPOKEN_API_KEY=<SPOKEN_API_KEY> -- npx -y spoken-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "spoken": {
            "url": "https://spoken.md/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "spoken": {
            "command": "npx",
            "args": [
                "-y",
                "spoken-mcp"
            ],
            "env": {
                "SPOKEN_API_KEY": "<SPOKEN_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "spoken": {
            "type": "http",
            "url": "https://spoken.md/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "spoken": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "spoken-mcp"
            ],
            "env": {
                "SPOKEN_API_KEY": "<SPOKEN_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http spoken https://spoken.md/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e SPOKEN_API_KEY=<SPOKEN_API_KEY> spoken npx -y spoken-mcp
```
Replace <…> with your own values

## When to use it
- get an episode's text without uploading audio
- replace anonymous speaker labels with real names
- split a transcript into chunks for a vector store
- track new episodes of shows you follow
- find an episode from a Spotify or YouTube link

## Example prompts
- Find a podcast episode about sleep and show me its transcript
- Pull the Markdown transcript for this episode with speaker names
- List new episodes of my followed shows that I haven't fetched yet

## Similar
- [sqlite-graph-memory](https://affpapa.org/en/nevibecode/mcp/sqlite-graph-memory.md) — MCP server · ★ 12
- [youtube-playlist](https://affpapa.org/en/nevibecode/skills/youtube-playlist.md) — skill · 714 installs
- [yt](https://affpapa.org/en/nevibecode/skills/yt.md) — skill · 694 installs
- [mcp-local-rag](https://affpapa.org/en/nevibecode/mcp/mcp-local-rag.md) — MCP server · ★ 425
- [loci](https://affpapa.org/en/nevibecode/mcp/loci.md) — MCP server · ★ 101
- [devrag](https://affpapa.org/en/nevibecode/mcp/devrag.md) — MCP server · ★ 64

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md