Hermes Agent

Hermes Agent (Nous Research) has first-class MCP support, so the cleanest route is the MCP server: Hermes loads the 44 Fokus tools with their schemas and treats them like any built-in toolset. If you'd rather have the agent coached on Fokus's conventions, the same fokus skill from OpenClaw works here too.

1. Install the CLI

Node.js 20+ on the machine running Hermes.

npm install -g @fokus-app/mcp     # or run it on demand with npx -y @fokus-app/mcp

2. Log in (once, as a human)

fokus-mcp login                  # email/password
fokus-mcp login --oauth google   # or microsoft / apple
fokus-mcp whoami                 # verify
fokus-mcp workspace              # optional: pick the default workspace

Self-hosted Fokus: add --api-url http://your-host:3000.

3a. MCP server (recommended)

Add to ~/.hermes/config.yaml:

mcp_servers:
  fokus:
    command: "fokus-mcp"

Self-hosted backend:

mcp_servers:
  fokus:
    command: "fokus-mcp"
    env:
      FOKUS_API_URL: "http://your-host:3000"

Restart Hermes. The Fokus tools appear alongside the built-in toolsets, along with the daily_planning and weekly_review prompts. Confirm with hermes mcp — the server should show as connected.

3b. Or install the skill

Hermes supports the agentskills.io format, so the same skill works:

cp -r /path/to/agent-skills/skills/fokus ~/.hermes/skills/fokus

Browse with /skills or invoke it with /fokus. The skill drives the fokus-mcp CLI through Hermes's terminal tool — so whichever terminal backend Hermes uses needs Node and the CLI installed inside it (that matters for Docker or remote backends).

Already had the skill in OpenClaw? hermes claw migrate imports it into ~/.hermes/skills/openclaw-imports/.

Try it

• "Add a task to finish the Q3 report by Friday, high priority"
• "What's on my calendar tomorrow?"
• "Create a weekly objective 'Ship v2 beta' and break it into tasks"
• "Auto-schedule my week"

Troubleshooting