Skip to content
appsgit

Codebase Memory

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 47,500 GitHub stars, is released under the MIT license and runs locally with npx -y codebase-memory-mcp.

github.com/DeusData/codebase-memory-mcp (opens in a new tab)

Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error

Install Codebase Memory

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.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

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

Cursor

.cursor/mcp.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
{
  "servers": {
    "codebase-memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "codebase-memory-mcp"
      ]
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Tools (17)

Parsed from the Tools section of the README; check the repository for the current list.

  • index_repository

    Index a repository into the graph. Auto-sync keeps it fresh only while it is the project of an open MCP session; repos…

  • list_projects

    List indexed projects with paging; use detail: "stats" for node/edge counts and database sizes.

  • 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

    Trace callers, callees, data flow, or cross-service paths (alias: tracecallpath).

  • 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

    Store observed call paths or caller/callee pairs under a run label.

About Codebase Memory

Understand your repository, from source code to the systems around it. codebase-memory-mcp is an MCP server that connects code, documentation, configuration, and infrastructure in a persistent local knowledge graph. Use it to find an unfamiliar feature, follow a call across services, trace a deployment back to its source, or assess which parts of a project a change could affect.

  • claude-code
  • code-analysis
  • code-intelligence
  • developer-tools
  • knowledge-graph
  • mcp
  • mcp-server
  • model-context-protocol
  • sqlite
  • tree-sitter

FAQ

Codebase Memory FAQ

Still curious? Email info@appsgit.com.

How do I install the Codebase Memory MCP server?

Add the command npx -y codebase-memory-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Codebase Memory free?

The server is open source under the MIT license, so running it is free. It does not declare any required API key.

Is Codebase Memory actively maintained?

The most recent commit was on Oct 26, 2026. The latest release is v0.12.1, published Oct 16, 2026. appsgit only lists MCP servers with a commit in the last six months.