# CueMap MCP server

> Provides AI agents with repository-aware memory and context retrieval through semantic search and codebase ingestion.

- Repository: https://github.com/cuemap-dev/cuemap-mcp
- Page: https://hostedmcp.org/servers/cuemap-dev/cuemap-mcp
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 0.7.5

## Install

### Claude Code

```sh
claude mcp add cuemap-mcp -- npx -y cuemap-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "cuemap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cuemap-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "cuemap-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cuemap-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"cuemap-mcp","type":"stdio","command":"npx","args":["-y","cuemap-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "cuemap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cuemap-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add cuemap-mcp -- npx -y cuemap-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.cuemap-mcp]
command = "npx"
args = ["-y", "cuemap-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user cuemap-mcp npx -- -y cuemap-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "cuemap-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cuemap-mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CUEMAP_PORT` | no | no |  |

## Tools (21)

- `cuemap_init_preview`
- `cuemap_init`
- `cuemap_status`
- `cuemap_projects`
- `cuemap_project_load`
- `cuemap_project_save`
- `cuemap_project_unload`
- `cuemap_project_sync`
- `cuemap_stats`
- `cuemap_memory_get`
- `cuemap_memory_reinforce`
- `cuemap_memory_delete`
- `cuemap_project_export`
- `cuemap_project_artifacts`
- `cuemap_ingest_url`
- `cuemap_ingest_content`
- `cuemap_ingest_file`
- `cuemap_add`
- `cuemap_intent_classify`
- `cuemap_recall`
- `query_embedding`

## FAQ

### Do I need to install the CueMap CLI manually?

No, the correct pre-compiled binary for your operating system is automatically downloaded via optional NPM dependencies.

### Does the server require a model download at runtime?

No, the engine bundles MiniLM-L3 models by default, so no model download occurs during runtime.
