← All MCP docs
MCP setup

Use Done in Hermes Agent

Connect Done to Nous Research's Hermes Agent: add https://trydone.app/mcp to config.yaml, sign in with hermes mcp login, and keep a to-do list your agent works from.

Who this is for

For people running Nous Research's Hermes Agent who want it to keep a real to-do list with them: it can capture tasks, work the ones you hand it, and park a question instead of guessing.

Set it up

Done's MCP server URL

https://trydone.app/mcp

Add the server and sign in Sign in with OAuth

  1. Add Done to ~/.hermes/config.yaml:
    mcp_servers:
  done:
    url: "https://trydone.app/mcp"
    auth: oauth
  2. Run hermes mcp login done and approve access in Done. Hermes registers itself, keeps the sign-in on your machine and refreshes it.
  3. Run hermes mcp test done to check it answers and lists Done's tools. In a running session, /reload-mcp picks up the change.

Or use a token MCP token

  1. Generate an MCP token in Done under Settings → Agent access, and send it as a header instead of auth: oauth:
    mcp_servers:
  done:
    url: "https://trydone.app/mcp"
    headers:
      Authorization: "Bearer <your-mcp-token>"

A token is the way on a headless host: Done doesn't offer the device-code sign-in Hermes can use there.

Need a narrower key? Under Settings → Agent access → Extra MCP tokens you can create one that's read-only, or limited to one project or one workspace — the agent then only ever sees that much.

What to say to it

Once Done is connected, talk to the assistant normally. Each of these maps to a real Done tool:

“What's on my plate today?”
get_todays_plan
“Add a task: send the invoice to Sam friday p1”
quick_capture
“Pick up your next Done task and propose a plan before you start.”
next_task → propose_plan
“If you hit a decision you can't make, ask me and keep going with the rest.”
ask_decision
“When it's finished, send it to me for approval.”
propose_completion

Every tool, prompt and resource Done exposes is listed in the MCP reference.

The approval gate

By default an assistant can't close your tasks. When it thinks a task is finished it calls propose_completion, which parks the task as Pending approval until you approve it or send it back from Needs you; substantial work starts with propose_plan, which waits for your go-ahead. A question goes through ask_decision: that task waits for your answer while the agent moves on to the next one. Done enforces this on its own server, so it holds whatever the assistant tries — an agent can only complete a task directly when you've set that task's Autonomy to let it.

Troubleshooting

invalid_client after reinstalling or reconnecting
Hermes is holding a stale sign-in. Remove the server, delete its saved token under ~/.hermes/mcp-tokens/, add it again and run hermes mcp login done.
Changes to config.yaml don't apply
Run /reload-mcp in the session, or restart Hermes.

FAQ

Can I let Hermes see only part of my board?

Yes: use a token from Extra MCP tokens that's read-only or limited to one project or workspace.

Is there a shared API key for Done?

No. Every connection belongs to one Done account: an OAuth sign-in, or an MCP token you generate yourself. There is no shared or global key. Each connected assistant is listed under Settings → Agent access, where you can revoke it in a click.

What can the assistant see?

Only what your account can see: your workspaces and anything shared with you. A read-only, one-project or one-workspace token narrows that further.

Does it cost anything?

The Free plan includes 100 agent (MCP) calls a month; Pro and Teams are unlimited. The assistant's own plan is separate.

Steps checked against the official documentation on October 23, 2026:

Other assistants