Codebase Memory

listing.by

Index a codebase into a persistent knowledge graph and answer structural code questions with fast local queries.

state.local.long (state.local.title)listing.badge.runs_with

listing.install

listing.local.explain

npx -y codebase-memory-mcp

listing.local.needs listing.local.note

listing.share.h

listing.share.p_local

mcp.tc/i/codebase-memory

listing.about

Codebase Memory parses a repository with tree-sitter and builds a persistent knowledge graph of functions, classes, call chains, HTTP routes and cross-service links. It covers 162 languages, adds semantic type resolution for several of them, and indexes Dockerfiles and Kubernetes manifests. The README lists 17 tools for search, tracing, architecture, impact analysis, Cypher queries and dead code detection.

It runs locally as a native binary over stdio, started with npx -y codebase-memory-mcp. It is also available from PyPI, Homebrew and an install script. No API key or sign-in is needed, and the README states that code never leaves the machine. A built-in graph visualization is served at localhost:9749.

listing.can

  • Index a repository into a persistent knowledge graph
  • Search and trace functions, classes and call chains
  • Run impact analysis and architecture overviews
  • Query the graph with Cypher
  • Detect dead code
  • Link HTTP routes across services
  • Explore the graph in a local 3D visualization

listing.tools

listing.notools.local

listing.prompts

  • Index this project

  • Trace the call chain that leads to the handleLogin function

  • What would be affected if I change the User class?

  • Find dead code in this repository

listing.setup.h

listing.setup.local

Claude Code

  1. Run this in a terminal, in your project folder:
claude mcp add --transport stdio codebase-memory -- npx -y codebase-memory-mcp
  1. Start Claude Code and type /mcp. codebase-memory should show as connected.

Add --scope user to make it available in every project.

Claude Desktop

  1. Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:
claude_desktop_config.json
{
  "mcpServers": {
    "codebase-memory": {
      "command": "npx",
      "args": [
        "-y",
        "codebase-memory-mcp"
      ]
    }
  }
}
  1. Save the file and restart Claude Desktop.

Needs Node.js on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Cursor

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

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

Needs Node.js on your computer.

VS Code

Or from a terminal:

code --add-mcp '{"name":"codebase-memory","type":"stdio","command":"npx","args":["-y","codebase-memory-mcp"]}'

Or commit it to the repo in .vscode/mcp.json:

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

Needs Node.js on your computer.

Devin Desktop

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "codebase-memory": {
      "command": "npx",
      "args": [
        "-y",
        "codebase-memory-mcp"
      ]
    }
  }
}
  1. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

Codex

codex mcp add codebase-memory -- npx -y codebase-memory-mcp

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.codebase-memory]
command = "npx"
args = ["-y", "codebase-memory-mcp"]

Needs Node.js on your computer.

Gemini CLI

gemini mcp add codebase-memory npx -- -y codebase-memory-mcp

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients that start local servers accept this shape:

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

Zed puts servers under context_servers in its settings, with the same command, args and env fields.

Needs Node.js on your computer.

listing.faq

Can I paste mcp.tc/i/codebase-memory into my MCP client?

No. Codebase Memory runs on your own computer, started by your client, so it has no web address to connect to. The quick link is the page to share; the install command is npx -y codebase-memory-mcp.

Does Codebase Memory need an API key?

No. It doesn't declare any keys or environment variables. It runs with your user account's permissions, so check what its tools can reach.

Is Codebase Memory a remote or a local server?

Local. Your client starts it as a process on your computer with npx -y codebase-memory-mcp, which needs Node.js.

What can Codebase Memory do?

You can index a repository into a persistent knowledge graph, search and trace functions, classes and call chains and run impact analysis and architecture overviews.

Which clients can use it?

Any client that starts local servers: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. claude.ai and ChatGPT only connect to remote servers.

Who wrote this page?

mcp.tc's robot read Codebase Memory's public metadata (its package and repository pages), and an AI model drafted the text from it. A person reviews anything the checks can't confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

listing.em.h

listing.em.lead_local listing.em.how

listing.em.badge

em.prev_lightem.prev_dark
Markdown
[![Codebase Memory on mcp.tc](https://mcp.tc/i/codebase-memory/badge.svg)](https://mcp.tc/i/codebase-memory)
HTML
<a href="https://mcp.tc/i/codebase-memory"><img src="https://mcp.tc/i/codebase-memory/badge.svg" alt="Codebase Memory on mcp.tc" height="20"></a>

listing.em.badge_note

listing.em.widget

HTML
<script src="https://mcp.tc/w/codebase-memory.js" async></script>

listing.em.widget_note

iframe

HTML
<iframe src="https://mcp.tc/embed/codebase-memory" title="Codebase Memory on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

listing.em.iframe_note

JSON

listing.em.json_local

https://mcp.tc/i/codebase-memory.json

listing.em.fields

listing.disclaimer_checked