# Codeix MCP server

> Provides AI agents with fast semantic code search to find symbols, references, and callers across codebases using a portable index format.

- Repository: https://github.com/montanetech/codeix
- Page: https://hostedmcp.org/servers/montanetech/codeix
- Transport: stdio
- Stars: 9
- License: Apache-2.0
- Latest version: 0.5.0

## Install

### Claude Code

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

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

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

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

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

### VS Code CLI

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

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

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

### Codex

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

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

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

### Gemini CLI

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

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

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

## Tools (7)

- `explore`
- `search`
- `get_file_symbols`
- `get_children`
- `get_callers`
- `get_callees`
- `flush_index`

## FAQ

### How does Codeix help AI coding agents?

It provides a pre-built map of the codebase, allowing agents to find symbols, signatures, and parent relationships in one tool call instead of scanning raw text.

### Is the index shareable between developers?

Yes, the index is stored in a .codeindex directory that can be committed to git, allowing others to use it without re-indexing.

### Does Codeix require an internet connection or API keys?

No, it is designed to be local-only, working offline and in air-gapped environments without any network or API key requirements.