Help

Setup with OAuth

Use this path when OpenClaw runs on a machine with a browser. OpenClaw registers itself with PodRead and asks you to approve access once.

1. Add PodRead as an MCP server:

   openclaw mcp set podread '{"url":"https://podread.app/mcp","transport":"streamable-http","auth":"oauth","oauth":{"redirectUrl":"http://localhost:8989/oauth/callback"}}'

2. Start the login:

   openclaw mcp login podread

   OpenClaw prints a PodRead URL and waits. Open the URL in your browser.
3. Sign in to PodRead if needed. Click Allow. The terminal prints MCP OAuth credentials saved for "podread".
4. Check the connection:

   openclaw mcp doctor podread --probe

   The output shows podread: ok.
5. Done. OpenClaw can now create podcast episodes for you.

The oauth.redirectUrl key makes OpenClaw use localhost for its callback. PodRead accepts only that host.

Setup with an API token

Use this path on a headless host, or when you do not want a browser step. A token does not expire. Treat it like a password.

1. Create a token in Settings, API Tokens. Copy it. PodRead shows it only once.
2. Put the token in the environment of the OpenClaw process. For example, add this line to the shell profile of the user that runs OpenClaw:

   export PODREAD_API_TOKEN=sk_live_...

3. Add the server to ~/.openclaw/openclaw.json:

   {
     mcp: {
       servers: {
         podread: {
           url: "https://podread.app/mcp",
           transport: "streamable-http",
           headers: { Authorization: "Bearer ${PODREAD_API_TOKEN}" },
         },
       },
     },
   }

4. Check the connection with openclaw mcp doctor podread --probe.

Do not paste the token into a chat. Chat services such as WhatsApp, Telegram, and Slack store the message.

Example prompts

Turn this article into a podcast episode: https://example.com/article

Create a podcast episode from this text: [paste your text]

Show me my recent episodes

What voices are available?

What's my podcast feed URL?

Articles over 50,000 characters fail. See Splitting long articles. To change the voice for your new episodes, go to Settings.

Troubleshooting