Connect Hermoso to Hermes Agent

Hermes signs in to hosted MCP servers with OAuth 2.1. It handles discovery, registration, PKCE, token exchange and refresh by itself, and Hermoso supports the dynamic client registration that relies on. So there is no key in your config.

Before you start

• Anyone running Hermes Agent.
• A Hermoso account. The free plan is enough to try it (see pricing). No account yet? Create one in the app first.

The steps

1. Add the server:

   hermes mcp add hermoso --url https://app.hermoso.ai/mcp --auth oauth

2. On first connect Hermes prints an authorize URL, opens your browser when it can, and waits for you. Sign in to Hermoso there. Hermes keeps the token in ~/.hermes/mcp-tokens/, readable only by you, and reuses it quietly after that.
3. If the sign-in did not finish, or you are setting this up from inside a running Hermes session, run it again from a fresh terminal:

   hermes mcp login hermoso

4. Add Hermoso's Agent Skills. They teach Hermes when to reach for Hermoso and in what order to call things. Add the public repo as a tap:

   hermes skills tap add hermoso-ai/hermoso

5. Or take them straight from this site, which publishes them at /.well-known/skills/index.json:

   hermes skills search https://hermoso.ai --source well-known
   hermes skills install well-known:https://hermoso.ai/.well-known/skills/hermoso-marketing

Rather edit the file? This is the same thing in ~/.hermes/config.yaml:

mcp_servers:
  hermoso:
    url: "https://app.hermoso.ai/mcp"
    auth: oauth

Running Hermes on a remote machine with no browser? Its MCP page covers how to finish the sign-in from another device. The Hermes hub has the other route, where Hermes starts Hermoso as a local process, and a page for every channel Hermes can post to.

What you will be asked to approve

Your browser opens Hermoso's own page. It asks whether to let Hermes use your Hermoso account, under whatever name Hermes registers itself with. Sign in if you aren't already, then select Allow. That is the only thing you approve. It lets Hermes research ads, plan creative and generate images and video on your account, the same things you can do in the app. There is no key to copy, and you can take it back any time in Hermoso under Settings, Agents & API.

Connecting Hermoso does not connect your ad accounts or social channels. You add those inside Hermoso, under Settings, Connectors, and only the ones you want. Ads are created paused, and nothing is posted or spent unless you ask for it.

A prompt to try

Want more like that? The workflows are ready prompts for whole marketing jobs: competitor research into ads, ads from customer reviews, a week of scheduled posts, a paused Meta campaign.

Related

• Everything the Hermoso MCP server does
• Connect Hermoso to Atlassian Rovo
• Connect Hermoso to Dify
• Connect Hermoso to Zapier
• Connect Hermoso to Zed
• Every host you can connect by URL

These steps follow Hermes Agent: MCP and Hermes Agent: CLI commands and Hermes Agent: Skills, read on 2026-09-20. Menus move, so if a name here no longer matches what you see, that page is the authority. Hermoso is not affiliated with or endorsed by the makers of Hermes Agent.