codebase-memory-mcp

Description written after our first hands-on test.

🧠 Code understanding★ 46,525Updated 2026-10-13Auth: noneGitHub ↗

SourcesGitHubDeusData/codebase-memory-mcp

Test results

Last passed 2026-10-14

Claude CodePassed2026-10-13 · install, connect, tools, agent task

CursorPassed2026-10-13 · install, connect, tools, agent task

Claude DesktopPassed2026-10-14 · install, connect, tools, agent task

ChatGPT (Codex)Passed2026-10-14 · install, connect, tools, agent task

Protocol: starts, 17 tools listed · 2026-10-13

Install

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

Run in your terminal. This exact command is what our harness runs in Claude Code; see the results above.

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

Save as .cursor/mcp.json. This exact config is what our harness runs in Cursor; see the results above.

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

Add to claude_desktop_config.json and restart Claude Desktop. Tested on the Linux beta; see the results above.

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

Add to ~/.codex/config.toml (shared by the ChatGPT (Codex) CLI and the ChatGPT desktop app; Codex runs inside the ChatGPT desktop app). Tested with the ChatGPT (Codex) CLI bundled in the ChatGPT desktop app; see the results above.

Not connecting? Troubleshooting: Claude Code · Cursor · Claude Desktop · ChatGPT (Codex)

Test history

Date	Check	Result	Version
2026-10-13	Protocol (direct stdio)	Protocol: starts, 17 tools listed	0.11.0
2026-10-13	Claude Code	Passed install, connect, tools, agent task	2.1.296 (Claude Code)
2026-10-13	Cursor	Passed install, connect, tools, agent task	2026.10.12-d47ca18
2026-10-14	Claude Desktop	Passed install, connect, tools, agent task	Claude Desktop 2.37337.1 (Linu
2026-10-14	ChatGPT (Codex)	Passed install, connect, tools, agent task	codex-cli 0.162.0-alpha.17.2

Tools seen by our harness (17)

index_repositorysearch_graphquery_graphtrace_pathget_code_snippetget_file_outlineget_graph_schemacompare_graphsget_architecturesearch_codelist_projectsdelete_projectindex_statuscheck_index_coveragedetect_changesmanage_adringest_traces