Connect Eden to Hermes Agent

Unlike Claude, Cursor, and ChatGPT — which have one-click buttons in Eden's Settings — Hermes Agent is configured from a file on your own machine. There's no button to press in Eden for this one. It's still only about a minute of work.

What you'll need

• Hermes Agent installed and working on your machine (you can already run hermes chat).
• An Eden account you can sign in to in a browser.

That's it. There's no API key to copy and no token to paste — Eden uses the same kind of secure sign-in window your bank uses for third-party apps (OAuth), and Hermes handles the rest for you.

Set it up

1. 01

   Open your Hermes config file

   It lives at ~/.hermes/config.yaml. Open it in any text editor. If the file doesn't exist yet, create it.

2. 02

   Add Eden under mcp_servers

   Add the block below. If you already have an mcp_servers: section, add the eden: entry inside it rather than creating a second section.

   mcp_servers:
     eden:
       url: "https://mcp.eden.so/mcp"
       auth: oauth
   

3. 03

   Start Hermes

   Run hermes chat. On the first connect, Hermes opens a browser window asking you to sign in to Eden and approve access. Sign in with the same account you use for Eden, approve, and the window closes.

4. 04

   Ask Eden something

   Back in Hermes, try a simple question like "what creators am I following?" or "show me the top posts on my swipe-file board" to confirm it's working.

You only sign in once. Hermes remembers the connection and refreshes it automatically from then on.

What to ask once it's connected

You don't have to name any tools — just ask a question and Hermes decides when Eden is the right source. The same questions that work in Claude or Cursor work here:

• "What's on my Hooks board?"
• "Analyze the creator @hormozi on Twitter — what are their top outliers?"
• "Who am I following on Substack?"
• "Read this saved YouTube video from my swipe file and pull out the three best ideas."

Eden has already done the heavy lifting on top posts, outliers, transcripts, and per-segment baselines, so Hermes gets the analysis back instantly rather than scraping in the moment. For the full menu of what you can ask, see connect Claude, Cursor, or ChatGPT — the question types are identical across every assistant.

Reading and writing

When you connect, Eden asks you to approve read and write access. Approve it and Hermes can both read your workspace — boards, saved posts, creator lists, the analysis Eden has already done — and act on it: save links and posts to a board, create and edit notes, create/rename/trash boards, and schedule or edit posts. Want it to only read? Deny the write request, or use a read-only personal access token. No connection can create folders, permanently delete, or change who you follow yet.

Managing or disconnecting

Even though you set Hermes up from a file, you manage it from Eden like any other assistant. Open Settings → Integrations and the AI assistants card shows every connected assistant, including Hermes, with when it was connected. Click Revoke on its row to cut off access immediately — Hermes won't be able to read your Eden content again until you reconnect.

To reconnect after revoking, just run hermes chat again and approve the sign-in window when it appears.

Troubleshooting

• Hermes says it can't see my Eden content. Confirm the eden: block is under mcp_servers: and the indentation matches the example (YAML is whitespace-sensitive). Then run /reload-mcp, or restart hermes chat.
• No sign-in window appeared. Make sure you used auth: oauth exactly. Without it, Hermes won't know to start the sign-in flow.
• "We're still indexing them" when I ask about a creator. The first time anyone asks Eden about a brand-new creator, Eden starts collecting their content in the background. Ask again in a few minutes and the rich analysis will be ready.

Where to go next

• To run your saved Eden prompts as /eden- slash commands, see using your prompts as slash commands.
• When new tools and slash commands ship, see getting the latest Eden MCP tools and slash commands.
• Prefer Claude, Cursor, or ChatGPT instead? See connect Claude, Cursor, or ChatGPT to your Eden workspace.
• Live in Raycast? See connect Eden to Raycast.