Help

Setup with OAuth

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

1. Add PodRead to ~/.hermes/config.yaml:

   mcp_servers:
     podread:
       url: "https://podread.app/mcp"
       auth: oauth

2. Start the login:

   hermes mcp login podread

   Hermes opens a PodRead page in your browser and prints the URL.
3. Sign in to PodRead if needed. Click Allow. The browser shows "Authorization Successful". The terminal prints Authenticated and the tool count.
4. Check the connection:

   hermes mcp test podread

   The output shows Connected and Tools discovered: 7.
5. Done. Hermes can now create podcast episodes for you.

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. Add the token to ~/.hermes/.env. Hermes reads this file at startup:

   PODREAD_API_TOKEN=sk_live_...

3. Add PodRead to ~/.hermes/config.yaml:

   mcp_servers:
     podread:
       url: "https://podread.app/mcp"
       headers:
         Authorization: "Bearer ${PODREAD_API_TOKEN}"

4. Check the connection with hermes mcp test podread. The output shows Authorization: *** and Tools discovered: 7.

Do not paste the token into a chat. Chat services such as Telegram, Discord, 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