Skip to content
sensefold Docs

Connect Hermes Agent to Sensefold

Part of Sensefold for agents — the overview, permission tiers, and tool table.

Hermes Agent supports remote HTTP MCP servers and OAuth 2.1 with PKCE. The normal local CLI flow opens a browser, returns to a loopback callback, and stores refreshable credentials under the active Hermes profile. No Agent key is needed.

Before you start

Section titled “Before you start”

Check that your Hermes installation has the current MCP commands:

Terminal window
hermes --version
hermes mcp --help

If mcp add, mcp login, or mcp test is missing, update Hermes first:

Terminal window
hermes update

Setup

Section titled “Setup”

Run:

Terminal window
hermes mcp add sensefold \
  --url https://api.sensefold.app/mcp \
  --auth oauth \
  --connect-timeout 60

Hermes prints and opens the Sensefold authorization URL. Sign in, keep the default read-only tier unless Hermes needs to save or update items, and approve the connection. Back in the terminal, enable the discovered tools.

Verify the live connection:

Terminal window
hermes mcp test sensefold
hermes mcp list

With read-only access, Hermes discovers six tools: search_hub, list_items, get_item, get_quota, search, and fetch. Write tools appear only after authorizing an edit or full-access connection.

To replace expired or revoked credentials later, run:

Terminal window
hermes mcp login sensefold

Remote Hermes gateways

Section titled “Remote Hermes gateways”

The normal flow uses a callback on 127.0.0.1, so it works directly when Hermes and the browser run on the same machine. If Hermes runs in a remote container or VPS, use Hermes’ official remote OAuth helper:

Terminal window
hermes skills install official/mcp/mcp-oauth-remote-gateway

Alternatively, create a revocable Agent key in Sensefold → Settings → For agents and configure it as a Bearer header. Never paste the key into a conversation or commit it to a project.

See the Hermes MCP reference for profile, filtering, and remote-gateway details.

Try it

Section titled “Try it”
  • “Search my Sensefold library for notes about OAuth compatibility.”
  • “Find the item I saved about agent memory and summarize its main idea.”

See the MCP tools reference for every Sensefold tool and permission tier, agent permissions for revocation and undo, and troubleshooting if the callback or login fails.

Tiers, revocation, and undo: Permissions. What the client receives: Privacy for connected AI. Problems: Troubleshooting.