Kireo

@kireo/mcp-server

Kireo gives Claude Code, Cursor, and any MCP client a shared long-term memory — save decisions and gotchas as you work, recall them from any tool, and browse, edit, or delete everything in a web dashboard. Free beta.

Quickstart

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

claude mcp add kireo --env KIREO_API_KEY=ki_sk_xxx -- npx -y @kireo/mcp-server

Add --scope user to make it available in every project. Alternatively, check a project-scoped .mcp.json into your repo root with the same shape:

// .mcp.json (project root)
{
  "mcpServers": {
    "kireo": {
      "command": "npx",
      "args": ["-y", "@kireo/mcp-server"],
      "env": { "KIREO_API_KEY": "ki_sk_xxx" }
    }
  }
}

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

Client setup

The server config is identical everywhere — only the file (or UI) each client reads it from differs. Use your ki_sk_… key from https://app.kireo.app/api-keys.

Claude Code — run claude mcp add kireo --env KIREO_API_KEY=ki_sk_xxx -- npx -y @kireo/mcp-server (add --scope user for all projects), or check a project-scoped .mcp.json into your repo root (see the Quickstart block above).

Cursor — ~/.cursor/mcp.json (or <workspace>/.cursor/mcp.json for a single repo):

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

Cline — open the MCP Servers panel → Configure MCP Servers, then add:

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

Claude Desktop — claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

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

Restart the client after editing. Any other MCP-compatible host (Windsurf, Zed, Continue …) uses the same command / args / env triple.

Configuration

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

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

Indexing local code

Index a repository's symbols (functions / classes / methods) into a code-<repo> namespace so the AI can recall them via memory_search:

export KIREO_API_KEY=ki_sk_xxx
npx -y -p @kireo/mcp-server kireo index ./ --repo my-app

Indexing is incremental — only changed files are re-sent on subsequent runs.

Run kireo --help for the full usage text. --help and --version never touch the network or the filesystem and don't require an API key. If a batch upload times out, re-running the same command is safe: the server dedupes identical symbols, so retries won't create duplicates.

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