MimirDocumentationSign in
Documentation

9 agents · all agents

Connect Hermes

Hermes talks to Mimir over the Model Context Protocol at https://mimir.johansen.foo/mcp. The token is an API key from Settings → API keys in the Mimir app; export it as MIMIR_TOKEN before starting the agent.

1. Add the server

File: the harness mcp config

json
{
  "mcpServers": {
    "mimir": {
      "url": "https://mimir.johansen.foo/mcp",
      "headers": {
        "Authorization": "Bearer ${MIMIR_TOKEN}"
      }
    }
  }
}

2. Verify

Ask the agent to run memory_tree. It should list the projects your token can see, or nothing at all on a fresh install — either answer proves the connection works.

3. Tell it how to behave

Paste this into the agent's rules or instructions file, once per machine.

text
You have a long-term memory store called Mimir.
At the start of a session, call memory_digest with the current repository to load what is already known.
Before answering a question about this project's conventions, call memory_search with a path_prefix (for example "conventions").
When you learn something durable — a decision, a convention, a gotcha — call memory_write with a path that says where it belongs.
Do not store secrets, tokens or customer data.

Notes

  • Hermes speaks plain JSON-RPC over HTTP, so any streamable-HTTP client works.
Hermes — Mimir