@kireo/mcp-server

@kireo/mcp-server

Long-term memory for any MCP-compatible AI tool (Claude Code, Cursor, Windsurf, Cline, Zed, Continue …).

Quickstart

• Get an API key at https://app.kireo.app/api-keys (ki_sk_…).
• Add this MCP server to your host. Claude Code example:

// ~/.claude/mcp.json
{
  "mcpServers": {
    "kireo": {
      "command": "npx",
      "args": ["-y", "@kireo/mcp-server"],
      "env": { "KIREO_API_KEY": "ki_sk_xxx" }
    }
  }
}

• Restart the host. You now have 8 tools available to the AI:

Tool	Purpose
memory_save	Persist a long-term memory
memory_search	Hybrid semantic + keyword search
memory_recall	Replay recent/important memories
memory_get	Fetch by id
memory_update	Patch fields
memory_delete	Soft/hard delete
memory_list_namespaces	Enumerate namespaces
memory_health	Probe service

Configuration

Sources are merged in order: CLI args > env > ~/.kireo/config.json.

ENV / CLI	Default	Description
KIREO_API_KEY / --api-key	required	Bearer token (ki_sk_…).
KIREO_API_URL / --api-url	https://api.kireo.app	Override for self-host.
KIREO_REQUEST_TIMEOUT_MS	10000	Per-request timeout (alias: KIREO_TIMEOUT_MS).
KIREO_RETRY_MAX_ATTEMPTS	3	5xx/429 retries (alias: KIREO_RETRY_MAX).
KIREO_RETRY_BASE_MS	200	Exponential backoff base.
KIREO_TELEMETRY	1	Set to 0 to disable device-id header.
KIREO_LOG_LEVEL	info	debug / info / warn / error / silent.
KIREO_PROXY_URL	none	HTTP(S) proxy.
KIREO_ACCEPT_LANGUAGE	en	Locale for error hints.

Logs land in ~/.kireo/logs/ on all platforms (macOS, Linux, Windows).

Host setup

• Claude Code
• Cursor
• Windsurf

Privacy

Set KIREO_TELEMETRY=0 to drop the X-Device-Id header. We never read your code; only the explicit content you pass to memory_save reaches the API.

Troubleshooting

• AUTH_INVALID_KEY → rotate your key at https://app.kireo.app/api-keys.
• QUOTA_EXCEEDED → upgrade or wait for next billing cycle.
• Tools missing in your host → run npx @modelcontextprotocol/inspector node $(npm root -g)/@kireo/mcp-server/bin/kireo-mcp.cjs to verify locally.

License

MIT