Skip to content

SocialGTM in Hermes Agent

Add SocialGTM to Hermes Agent with a few lines of config and check your reply queue from the terminal. Hermes handles the OAuth sign-in and keeps the token fresh.

Connect it

  1. Add this to ~/.hermes/config.yaml:
    mcp_servers:
      socialgtm:
        url: "https://socialgtm.app/api/mcp"
        auth: oauth
  2. Sign in. Hermes opens SocialGTM in your browser; log in and choose Allow.
    hermes mcp login socialgtm
  3. In a session, reload the servers and ask for your queue.
    /reload-mcp

No API key. You sign in with your SocialGTM account, and the connection works in the workspace you had open when you allowed it.

What you need

A recent Hermes Agent. On a machine with no browser, paste the redirect URL back at the prompt, use hermes mcp login --flow device if the server supports it, or forward a port over SSH.

What to ask

  • “Look at my SocialGTM matches, keep the ones from people who asked a direct question, and write short replies in my voice. Show me each before anything is approved.”
  • “What's waiting in my SocialGTM queue? Show me the three best replies with the posts they answer.”

Limiting the tools

Under the server, add tools: { exclude: [approve_draft, reject_draft] } so Hermes can read your queue and write drafts but not approve them. include does the opposite and registers only the tools you list, and wins if both are set.

Reloading

Run /reload-mcp in a session after editing the config. A running gateway (hermes gateway run) picks up changes to config.yaml itself within about a minute.

Pausing or removing it

Set enabled: false to keep the entry without connecting. To remove it, delete the entry from mcp_servers; a running gateway then closes the connection.

What it can do

It reads your queue, drafts, matches and mentions, and can write, approve or reject replies, under the same reply limits and safety holds as the SocialGTM app. On X, Reddit and LinkedIn you still post each reply yourself. See everything it can do.

If it doesn’t connect

  • If you need more than a minute to approve in the browser, raise oauth.timeout (in seconds) on the server.
  • If Hermes keeps asking to sign in, run hermes mcp login socialgtm again. The saved token is in ~/.hermes/mcp-tokens/socialgtm.json.

Setup steps follow Hermes Agent docs: MCP.

Other AI apps

Plans start at $9 a month. Create your agent, then connect it.