How it works / Connect Hermes · Leer en español

Add Spica Post to Hermes.

Hermes runs on your own computer or server and is set up with a settings file and a few commands. You add the link, sign in once in your browser, and Hermes can write and schedule your posts from wherever you talk to it.

app.spicapost.com/mcp

A smiling woman with curly blonde hair in a knit sweater holding a large plug, about to plug it into the matching socket on the robot's chest

Command names in Hermes change between versions. If a step looks different, run hermes mcp --help.

Before you start

  • A Spica Post account with at least one social account connected.
  • Your MCP link, shown on your Spica Post account page.
  • Hermes Agent installed, and a terminal on the machine it runs on.

The short way

Send Hermes this line. It reads the steps and adds the connection itself, and you only sign in. If it can't, do it by hand below.

Set me up with Spica Post. Follow https://spicapost.com/agents.txt

By hand

  1. Open ~/.hermes/config.yaml and add Spica Post under mcp_servers:
    mcp_servers:
      spica-post:
        url: "https://app.spicapost.com/mcp"
        auth: oauth
  2. Run hermes mcp login spica-post. Hermes opens the Spica Post login page in your browser. Sign in and approve the connection.
  3. Run hermes mcp test spica-post to check that the connection works.
  4. If Hermes is already running, type /reload-mcp in that session.
  5. Ask for a post. For example: "Every Monday, draft the week's posts from what I tell you and show them to me before anything is scheduled."

Good to know

No key goes in the settings file. Hermes keeps the sign-in on that machine and renews it by itself. On a server with no browser, Hermes prints the login address: open it on your own computer, sign in, and paste the address you land on back into Hermes.

If something goes wrong

  • The login page doesn't open. Remove the connection in Hermes and add the link again.
  • The assistant says an account needs reconnecting. Open the reconnect link it gives you, sign in to that platform again, then repeat your request.
  • A post fails a check. The assistant is told which of the platform's limits it went over. Ask it to fix the draft and try again.

Next: how it works, pricing or everything your assistant can do.

Get your evenings back.

Set up in a few minutes. Your first week of posts can be scheduled today.

Works with the assistant you already use: Claude, ChatGPT, Gemini, Grok and more.

A smiling woman with curly blonde hair in a champagne dress, drawn in the same soft style as the Spica Post mascot