Eden MCP

Connect Eden to Hermes Agent

Add Eden to Hermes Agent's config, sign in once, and ask it about your boards, notes, and creator research from the terminal.

·3 min read

Hermes Agent can read your Eden workspace, save links, write notes, and draft posts. Add Eden's server URL, https://mcp.eden.so/mcp, to Hermes' config and sign in once. No token to copy.

Connect

  1. 01

    Add Eden to the Hermes config

    Open ~/.hermes/config.yaml and add Eden under mcp_servers. If that section already exists, add only the eden: entry.

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

    Start Hermes and sign in

    Run hermes chat. A browser window opens. Sign in with your Eden account.

  3. 03

    Click Connect Eden

    Eden lists what Hermes can do. Click Connect Eden, then go back to the terminal.

Hermes shows up in Eden under Settings → MCP → Other connected apps. From there you can switch it to Read-only or click Revoke to cut it off. It can't permanently delete content or change who you follow.

Limit what Hermes can do

To pick exactly what Hermes can touch, connect it with an API key instead of signing in.

  1. In Eden, go to Settings → API, pick Custom, and set a level for each part. For example: Boards and documents on Edit, Store on Read, Scheduling on Off.
  2. Click Generate key, then Copy.
  3. Swap the eden: entry in ~/.hermes/config.yaml for this, then restart Hermes:
mcp_servers:
  eden:
    url: "https://mcp.eden.so/mcp"
    headers:
      Authorization: "Bearer <your key>"

Hermes only sees the tools the key allows. See Use the Eden API for what each level means.

Try it

Ask HermesEden tool it uses
"Who am I following on Substack?"eden_following_overview
"What are @hormozi's top outlier posts on X?"eden_analyze_creator
"Add today's takeaways to my Ideas note."eden_append_to_note

If something's off

You seeDo this
No sign-in windowCheck the eden: block sits under mcp_servers: with auth: oauth, then restart Hermes.
Unauthorized: access token expired or revokedRun hermes chat again and sign in.
This connection has read-only access to EdenIn Settings → MCP, switch Hermes to Read & write.
Write tools missing even on Read & writeOpen Tool permissions on the same page and turn on Allow write tools.
You're out of creditsResearch tools, like creator analysis, use credits. Reading your own items is free.
Related articles

Use the Eden API

Make an API key and connect your own code, a checkout, or an automation tool to your Eden store and workspace.

Connect your AI app to Eden

Setup steps for Claude, ChatGPT, Cursor, Claude Code, Codex, and other MCP apps, plus how to limit access, pick a workspace, and disconnect.

Get the latest Eden MCP tools

When a new Eden tool or command doesn't show up in Claude, ChatGPT, Cursor, or a coding agent, here's how to make your app load the current list.

Ask the community

Get answers from the team and other creators.

Ask in the Eden help channel, see how others use the app, and come to the live workshops. Free with any Eden account.

Join the Eden Community
Still stuck?

Email us. A real person reads every message.

Tell us what you tried and where you got stuck. We answer within one business day.

[email protected]