All agents

Connect Koma to Hermes Agent

Hermes Agent sees what's due, adds what you mention, and knows what's next.

How to connect

In ~/.hermes/config.yaml, add the server under mcp_servers, then sign in from the terminal:

yaml
mcp_servers:
  koma:
    url: "https://koma.ac/api-preview/mcp"
    auth: oauth
bash
hermes mcp login koma

How to use it

Once connected, talk to Hermes Agent the way you already do. Koma is there whenever a task comes up:

  • "What's on my plate today?"
  • "Add "call the dentist" and "send the invoice", both for Friday."
  • "Save the plan we just made as a note."

Make Koma your to-do list

Koma works best as the one list behind everything: tell Hermes Agent what you need to do and it lands in Koma; ask any agent, or Koma itself, what is next and it answers from the same list. Nothing lives only in one chat.

Send this once. Hermes Agent makes Koma its to-do list, looks through your recent conversations for what is still open, and keeps Koma current as you work.

Koma is my to-do list from now on. Look through our recent conversations for anything I still need to do, show me the list, and after I confirm add it to Koma. From here on: add anything I mention needing to do to Koma, answer "what should I work on next" from Koma, and when something we discussed gets done or changes, update it in Koma.

What Hermes Agent can do in Koma

  • Context. See where you are: what is due, your lists, recent notes, and what you asked Koma to remember.
  • Lists. Keep any list: your tasks, your notes, a reading list, a CRM, each with the properties you give it. Create one, reshape it, delete it.
  • Items. Add, update, move and delete what is on a list, many at once: a task with its due date, a note, a book on a reading list, each with a body to work in.
  • Search. Find anything you keep, by meaning or keyword.
  • Chats. Read the chat on an item, and leave a note there under its own name, so you see it on every device.
  • Trash. Nothing is lost on delete: the trash keeps it for about 30 days and puts it back.
  • Automations. Read your automations and what their runs found, and start one when you ask.

Hermes Agent only ever acts as you, on your own workspace, and asks before anything changes.

Good to know

Add the server and sign in before you start a session: Hermes connects to its servers when it starts, a running session keeps its tools until /reload-mcp or /new, and its own reload gives a sign-in only thirty seconds, so run the login from a terminal of its own. The login opens a browser; on a machine without one, copy the address the browser ends up on and paste it back into the terminal where Hermes asks for it. A sign-in started from Hermes Desktop's MCP setup completes on its own. Koma's tools appear as mcp__koma__<tool>, so mcp__koma__get_context; hermes mcp test koma shows what the server answered. For a key instead of the sign-in (a gateway with no browser), replace auth: oauth with headers: { Authorization: "Bearer koma_…" }.

If the sign-in window does not open at all, some setups block it. Tell the app that it did not open; it gives you the link to open yourself.

Go deeper

The setup above is all most people need. The developer docs have the rest: every tool with what it takes and returns, guides for saving research, filling a list and running a worker loop, the standing orders to paste into a scheduled Hermes Agent so it sweeps your mail, calendar and meeting notes into Koma on its own, the event feed and the REST API. Developers.