Searches podcast episodes and returns published transcripts as Markdown with speaker names through the Spoken API.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add spoken --env SPOKEN_API_KEY='<SPOKEN_API_KEY>' -- npx -y spoken-mcp~/.codex/config.toml
[mcp_servers.spoken]
command = "npx"
args = ["-y", "spoken-mcp"]
env = { SPOKEN_API_KEY = "<SPOKEN_API_KEY>" }
# codex mcp add spoken --env SPOKEN_API_KEY='<SPOKEN_API_KEY>' -- npx -y spoken-mcp~/.cursor/mcp.json
{
"mcpServers": {
"spoken": {
"command": "npx",
"args": [
"-y",
"spoken-mcp"
],
"env": {
"SPOKEN_API_KEY": "<SPOKEN_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"spoken": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"spoken-mcp"
],
"env": {
"SPOKEN_API_KEY": "<SPOKEN_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"spoken": {
"command": "npx",
"args": [
"-y",
"spoken-mcp"
],
"env": {
"SPOKEN_API_KEY": "<SPOKEN_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"spoken": {
"command": "npx",
"args": [
"-y",
"spoken-mcp"
],
"env": {
"SPOKEN_API_KEY": "<SPOKEN_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"spoken": {
"command": "npx",
"args": [
"-y",
"spoken-mcp"
],
"env": {
"SPOKEN_API_KEY": "<SPOKEN_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http spoken https://spoken.md/mcp --header 'Authorization: <AUTHORIZATION>'~/.codex/config.toml
[mcp_servers.spoken]
url = "https://spoken.md/mcp"
http_headers = { Authorization = "<AUTHORIZATION>" }
# codex mcp add spoken --url https://spoken.md/mcp~/.cursor/mcp.json
{
"mcpServers": {
"spoken": {
"url": "https://spoken.md/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"spoken": {
"type": "http",
"url": "https://spoken.md/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"spoken": {
"httpUrl": "https://spoken.md/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"spoken": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://spoken.md/mcp",
"--header",
"Authorization:<AUTHORIZATION>"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"spoken": {
"url": "https://spoken.md/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}Environment variables
SPOKEN_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.