# Codebase Memory (MCP server)

> Codebase Memory is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens. It has 45,917 GitHub stars, is released under the MIT license and runs locally with npx -y codebase-memory-mcp.

The fastest and most efficient code intelligence engine for AI coding agents. Full-indexes an average repository in milliseconds, the Linux kernel (28M LOC, 75K files) in 3 minutes. Answers structural queries in under 1ms. Ships as a native executable with a small verified runtime-asset set for macOS, Linux, and Windows — download, run install, done.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/DeusData/codebase-memory-mcp |
| GitHub stars | 45,917 |
| License | MIT |
| Language | C |
| Transport | stdio |
| Packages | npm: codebase-memory-mcp; pypi: codebase-memory-mcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Developer tools |
| Latest release | v0.11.0 (Sep 15, 2026) |
| Last commit | Oct 6, 2026 |
| MCP registry name | io.github.DeusData/codebase-memory-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

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

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio codebase-memory -- npx -y codebase-memory-mcp
```

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

```json
{
  "mcpServers": {
    "codebase-memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "codebase-memory-mcp"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

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

Config formats checked against the official docs on 2026-10-07.

## Tools

- `index_repository`: Index a repository into the graph. Auto-sync keeps it fresh after that.
- `list_projects`: List all indexed projects with node/edge counts.
- `delete_project`: Remove a project and all its graph data.
- `index_status`: Check indexing status of a project.
- `check_index_coverage`: Check whether exact paths or a scope are indexed and fresh. A clean result means no recorded gap, not proof of…
- `search_graph`: Structural, BM25, and semantic search. Page structural rows with offset/limit and ranked semantic rows independently…
- `trace_path`: BFS traversal — who calls a function and what it calls (alias: tracecallpath). Depth 1-5.
- `detect_changes`: Map git diff to affected symbols + blast radius with risk classification.
- `query_graph`: Execute Cypher-like graph queries (read-only).
- `get_graph_schema`: Node/edge counts, relationship patterns, property definitions per label. Run this first.
- `compare_graphs`: Compare two indexed snapshots: node/edge additions and removals between a base and a target.
- `get_code_snippet`: Read source code for a function by qualified name.
- `get_file_outline`: Declaration outline of one repository-relative file in source order, with optional label filter and paging.
- `get_architecture`: Codebase overview: languages, packages, routes, hotspots, clusters, ADR.
- `search_code`: Grep-like text search within indexed project files.
- `manage_adr`: CRUD for Architecture Decision Records (get reads, update replaces the whole document, setsections rewrites only the…
- `ingest_traces`: Ingest runtime traces to validate HTTP_CALLS edges.

## Similar MCP servers

- [Gemini CLI](https://appsgit.com/mcp-servers/gemini-cli): An open-source AI agent that brings the power of Gemini directly into your terminal. (107,240 stars, Apache-2.0)
- [Front-End Checklist](https://appsgit.com/mcp-servers/front-end-checklist): Review frontend code and live pages against 386 quality-gated web development rules. (74,390 stars, MIT)
- [Claude Flow](https://appsgit.com/mcp-servers/claude-flow): AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev. (74,016 stars, MIT, needs API key)
- [Bytedance Filesystem](https://appsgit.com/mcp-servers/bytedance-filesystem): MCP server for filesystem access. (39,206 stars, Apache-2.0)
- [GitHub](https://appsgit.com/mcp-servers/github): Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language. (33,414 stars, MIT, official, needs API key)
- [Repomix](https://appsgit.com/mcp-servers/repomix): Pack local or remote codebases into AI-friendly files that LLMs and coding agents can read or search. (28,734 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/codebase-memory
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.