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.
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 ClaudeAlready 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.
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
/mcpUsage 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"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.
Available Tools
The Audioscrape MCP server provides these tools:
For detailed tool documentation, see the MCP Overview.
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.comto your network allowlist (*.audioscrape.comworks 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
-
Audioscrape is not listed under /mcp
Make sure Claude Code is signed in with the Anthropic account that added the connector (
/loginshows 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 audioscrapeand 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.
Need Help?
Having trouble with Claude Code integration? Contact us at [email protected].