How do I connect Kafkai to Hermes?

Hermes runs without a browser, so it authenticates with an API token instead of a sign-in.

  1. Create a token on the API tokens page and copy it. Kafkai shows it only once, at creation.
  2. Put the token in ~/.hermes/.env as KAFKAI_API_TOKEN=YOUR_API_TOKEN.
  3. Add Kafkai to ~/.hermes/config.yaml:
mcp_servers:
  kafkai:
    url: "https://kafkai.com/mcp"
    headers:
      Authorization: "Bearer ${KAFKAI_API_TOKEN}"

Run /reload-mcp in Hermes, or restart it. The Kafkai tools appear with the mcp_kafkai_ prefix, for example mcp_kafkai_list_projects.

Any other MCP client that can send an Authorization header connects the same way. The full guide, including other clients: Connect Hermes and Other Clients.

What to ask once it is connected: Example Prompts.

Last updated -