Integrations

Connect Audioscrape to Claude Code

Claude Code brings Claude to your terminal. Add Audioscrape once from the Claude connector directory and it is available in every Claude Code session signed in with the same Anthropic account — nothing to configure in the terminal.

Directory

1. Add Audioscrape to your account

Open the Audioscrape entry in the Claude connector directory, click Add, and sign in with your Audioscrape account when Claude asks you to connect.

Add Audioscrape to Claude

Already added it for Claude on the web or desktop? Then you are done — it is the same connector. No Audioscrape account yet? Sign up free first.

Terminal

2. Check it in Claude Code

Start Claude Code signed in with that account and type /mcp. Audioscrape is listed with the other connectors from your account. If you added it while a session was open, start a new session.

# inside a Claude Code session
/mcp
Usage

Usage Examples

Once connected, ask Claude in plain language — it picks the right tool:

# search for recent discussions
"Find recent podcast episodes about AI safety"

# research a specific topic
"What have experts said about climate change in the last month?"

# get episode details
"Show me the full transcript from episode 12345"

# browse a podcast
"List the latest episodes from the Lex Fridman podcast"
Alternative

Register the server by hand instead

Use this when Claude Code runs with an API key rather than a Claude account, in CI, or against a different Audioscrape server. It registers the MCP server for this machine only:

# one line — registers the Audioscrape MCP server
claude mcp add audioscrape --transport sse https://mcp.audioscrape.com/sse

The first time you use an Audioscrape tool, Claude Code opens a browser window for OAuth. If you are already signed in on audioscrape.com you go straight to the authorize screen; if you use the emailed link, open it in the same browser on the same device, or the local callback will not complete. claude mcp list shows the server; claude mcp remove audioscrape removes it.

Tools

Available Tools

The Audioscrape MCP server provides these tools:

Tool What it does
search_audio_content Search across all podcast transcripts with text or semantic search
list_recent_episodes Get recent episodes with optional filtering by podcast or date
get_episode_content Retrieve full transcript and metadata for a specific episode
browse_podcast Browse episodes from a specific podcast series

For detailed tool documentation, see the MCP Overview.

Optional

Uploading Audio from Claude Code

Search, transcripts and status need no extra permissions. Only uploading an audio file for transcription touches the network directly: Claude Code requests a one-time upload address from the request_upload_url tool and then uploads your file to it (typically with curl -T).

  • In a default setup, just approve the upload command when Claude Code asks — the address points at mcp.audioscrape.com, the same endpoint the MCP server runs on.
  • In a sandboxed or egress-restricted environment, add mcp.audioscrape.com to your network allowlist (*.audioscrape.com works too).

Upload addresses are valid for 15 minutes and work exactly once. Transcription starts on arrival and counts against your plan's monthly minutes; if a recording doesn't fit the minutes you have left, the tool result says so immediately — nothing is queued silently.

Troubleshooting

Troubleshooting

  • Audioscrape is not listed under /mcp

    Make sure Claude Code is signed in with the Anthropic account that added the connector (/login shows which), that the connector shows as connected under Settings → Connectors on claude.ai, and start a new session. Sessions running on an API key don't see account connectors — register the server by hand instead.

  • Authentication fails or times out

    Ensure you have an active Audioscrape account and that your browser can open the OAuth page. For a hand-registered server, run claude mcp remove audioscrape and add it again.

  • Getting rate limit errors

    Your account may have reached its search limit. Check your usage at Profile → Usage or upgrade your plan at Pricing.

Support

Need Help?

Having trouble with Claude Code integration? Contact us at [email protected].