onairos-hermes-mcp

MCP server that connects Onairos personality profiles to the Hermes AI agent.

One install. Zero config. Your agent knows who you are.

How it works

npm install -g onairos-hermes-mcp

You: Connect my Onairos profile
Hermes: [opens browser → onairos.io/connect]
You: [sign in, connect accounts, train model]
You: Done
Hermes: You're a Strategic Analyst — analytical, tech-focused...
        Saved to memory.

Every future Hermes session uses your personality profile.

What happens

1. Install — postinstall auto-detects Hermes (~/.hermes/) on native, WSL, or Windows and adds the MCP server to config.yaml
2. Connect — onairos_connect tool opens your browser to sign in with Onairos
3. Sync — onairos_sync tool fetches your traits via the Onairos API and returns them to the agent
4. Remember — Hermes writes your personality to USER.md so it persists across sessions

Manual setup

If the auto-config doesn't find your Hermes install, add this to ~/.hermes/config.yaml:

mcp_servers:
  onairos:
    command: "npx"
    args: ["-y", "onairos-hermes-mcp"]

Configuration

| Environment Variable | Default | Description | |---|---|---| | ONAIROS_API_URL | https://api2.onairos.uk | Onairos backend API | | ONAIROS_CONNECT_URL | https://onairos.io | Connect page URL |

Set these in the env block of your MCP server config if needed.

Tools

| Tool | Description | |---|---| | onairos_connect | Opens the browser for sign-in. Returns immediately with a link. | | onairos_sync | Fetches personality traits after the user completes the browser flow. |

Architecture

Hermes → onairos_connect → creates session → opens browser
User completes SDK flow in browser → traits saved to DB
Hermes → onairos_sync → fetches JWT → calls /traits-only → returns traits
Hermes writes traits to USER.md

License

MIT