# Kivgraph MCP Server for Codex

Source: https://kivgraph.dev/mcp/codex/
Kivgraph documentation, licensed Apache-2.0 (https://spdx.org/licenses/Apache-2.0.html).

---

Kivgraph can serve as a local **code intelligence MCP server for Codex**. It exposes repository structure, symbols, references and bounded impact through the MCP configuration used by Codex.

## Register Kivgraph with Codex

After installing Kivgraph, run:

```bash
kivgraph mcp install --scope user --target codex
```

This writes the `kivgraph` server entry to `~/.codex/config.toml`. For a project-only configuration:

```bash
kivgraph mcp install --scope project --target codex
```

The project entry is written to `.codex/config.toml` in the current repository.

## Build the repository graph

Register the repository and publish a full graph:

```bash
kivgraph init \
  --repository project=/absolute/path/to/project \
  --languages go,typescript,rust
kivgraph index --full
```

Codex can then use Kivgraph for semantic code navigation and questions about repository relationships, callers, dependencies and change impact.

Start with [`find_references`](/docs/tools/find-references/) for direct references or [`get_blast_radius`](/docs/tools/get-blast-radius/) before a risky change.
