Spoken

by roberttomko

3 stars

411 downloads

Not rated

GitHub Website

About

Podcast transcript API — turn any published podcast into clean Markdown with real speaker names. Built for AI agents.

Details

Author: roberttomko
GitHub stars: 3
Downloads: 411
Categories: Media, AI, Knowledge Base, API, Developer Tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Spoken

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

From the repository

Install and configure the MCP server via npx -y spoken-mcp or from source, setting the SPOKEN_API_KEY environment variable. Add the server to your MCP client config (e.g., Claude Desktop’s claude_desktop_config.json) to expose tools like search_podcasts, list_episodes, get_transcript, and get_balance. Alternatively, use the HTTP API directly via curl with an x-api-key header.

`search_podcasts`

Search published podcast episodes by text query, or paste an episode URL (Spotify, YouTube, etc.). Returns matching episodes with their id, title, podcast, podcast_id, and date. Use the id with get_transcript, or the podcast_id with list_episodes to get the show's whole back-catalog. Does not consume credits.

`get_transcript`

Fetch a podcast episode's transcript as clean Markdown with real speaker names and timestamps. Pass an episode id from search_podcasts. Costs 1 credit on the first fetch of an episode; repeat fetches are free and errors are never charged.

`list_episodes`

List a podcast's entire back-catalog (every episode, newest first). Pass a podcast_id from a search_podcasts result. Returns each episode's id, title, and date — fetch any with get_transcript. Use this to transcribe a whole show. Does not consume credits itself; transcribing the returned episodes costs 1 credit each (repeat fetches are free), so make sure the key has enough credits before looping.

`get_balance`

Check the current Spoken credit balance, account email, and recent usage for the configured API key. Does not consume credits.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "spoken": {
            "spoken": {
                "command": "npx",
                "args": [
                    "-y",
                    "spoken-mcp"
                ],
                "env": {
                    "SPOKEN_API_KEY": "pt_demo"
                }
            }
        }
    }
}

McpServers

{
    "spoken": {
        "command": "npx",
        "args": [
            "-y",
            "spoken-mcp"
        ],
        "env": {
            "SPOKEN_API_KEY": "pt_demo"
        }
    }
}

Spoken — podcast transcripts as clean Markdown, built for AI agents

Spoken is a transcript API that turns any published podcast into clean Markdown with real speaker names — not "Speaker 1." One API call returns named, timestamped text, ready for LLMs, RAG pipelines, summarizers, and search.

It's a transcript retrieval API, not a speech-to-text service: it works on already-published podcasts, so you skip uploading audio, running diarization, and mapping anonymous speaker labels by hand. For published shows that's typically 5–10× cheaper than running the audio through a transcription service.

- 🎙️ Real speaker names, resolved automatically
- 📄 Clean Markdown with timestamps, tuned for LLM context windows and RAG chunking
- 🔎 Search by text query or paste a Spotify/YouTube URL
- 💳 Pay-per-use credits — no subscription, failed calls never charged, repeat fetches free
- 🤖 Agent-native — ships with an Agent Skill, agents.md, llms.txt, and an OpenAPI spec

Get a key at spoken.md — or try it free with the demo key pt_demo (search works fully; transcripts limited to the demo episode).

Quickstart

```sh

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

search_podcasts

get_transcript

list_episodes

get_balance

Claude Desktop / Cursor

McpServers

Spoken — podcast transcripts as clean Markdown, built for AI agents

Quickstart

Install

More like this

Aws Kb Retrieval Server

Memory

Google Maps

Context 7

1Panel

🔎 GPT Researcher

`search_podcasts`

`get_transcript`

`list_episodes`

`get_balance`