castDocs

Connect Claude.ai

Use cast0 from Claude.ai (chat product) via the MCP custom connector, with Skills + Code Execution as a fallback.

Claude.ai (the chat product at claude.ai, web and desktop and mobile) connects to cast0 in three ways. The cleanest is the MCP custom connector (recommended). Skills + Code Execution still works if you prefer it. Project + manual curl is the fallback for Free plan users where Code Execution is not available.

If you use Claude through the CLI or an IDE, see Connect Claude Code instead.

Pro, Max, Team, and Enterprise. The cast0 MCP server gives Claude direct access to the create/get/list episode tools. No skill upload, no Python sandbox, no curl.

Grab your MCP URL

Sign in at cast0.ai, open your podcast, and click Connect on the MCP Server card. You land on the MCP page with your URL prefilled. It looks like:

https://api.cast0.ai/mcp?key=pk_...

The API key in the URL handles authentication, so the connector needs no extra credentials.

Add the connector in Claude.ai

In Claude.ai, navigate to Settings > Connectors, click + Add custom connector, and enter:

  • Name: cast0
  • MCP Server URL: the URL from the previous step

Click Add. The connector is enabled immediately.

Use cast0 in a chat

Click + in the chat, hover over Connectors, and toggle on cast0. Then ask:

  • "Turn this article into a podcast episode."
  • "Post a morning briefing summarizing my open PRs."

Claude calls create_episode directly, and you can poll get_episode or list_episodes from the same chat.

Skills + Code Execution (alternative)

Pro, Max, Team, and Enterprise. Useful if you want Python in the loop or you prefer not to use connectors.

Enable Skills and Code Execution

In Claude.ai, open Settings > Capabilities and enable Skills and Code Execution. Team and Enterprise owners must turn these on for the workspace first.

Allow outbound HTTP to api.cast0.ai

By default, Code Execution can only reach package registries. To call cast0 from a chat, change the Code Execution network setting to All domains (or, on Team/Enterprise, ask your owner to add api.cast0.ai to the allowlist). Without this step, Code Execution requests to the cast0 API are blocked.

Upload the cast0 skill

Download SKILL.md. In Claude.ai, open Customize > Skills, click +, choose Upload a skill, and pick the file. Toggle the skill on.

Tell Claude your API key, then ask normally

Paste your API key into a chat (or into a Project's instructions for persistent setup). Then ask:

  • "Turn this article into a podcast episode."
  • "Post a morning briefing summarizing my open PRs."

Claude reads the skill, runs Python in Code Execution, calls POST /api/episodes, and confirms the episode id.

Project + manual curl (Free plan fallback)

Works on every plan including Free. No settings to flip. You run the curl in a terminal yourself.

Create a Project and paste the skill

In Claude.ai, create a Project for cast0. Paste the body of cast0.ai/SKILL.md into Project instructions. Append your API key (pk_...) at the bottom. Save.

The Project instructions hold your API key. Keep the Project private; anyone you share it with can read the key and create new episodes on your podcast.

Ask Claude for the curl, then run it

Ask normally:

  • "Turn this article into a podcast episode." (paste a URL or text)
  • "Generate a 5-minute briefing on this report and post it."

Claude drafts the curl. Paste it into a terminal and run. The episode lands in your RSS feed when it finishes rendering.

What's next

On this page