Graph-MIND — Claude Code MCP server: memory and setup
Graph-MIND keeps conversation memory on your computer and lets connected AI agents retrieve useful past context in later sessions.
claude mcp add graph-mind -- uvx graph-mind-memoryWhat Graph-MIND does
Graph-MIND gives AI agents one shared memory store on your computer. Conversations are kept word for word, while local retrieval combines word matches, semantic search and timestamps. When a question depends on earlier work, the server can return the relevant turns instead of the whole history.
A background capture service works with transcripts, hooks and plugins from supported clients. Semantic retrieval uses an mpnet embedding model in ONNX with int8, and it does not require a GPU. Secrets are masked before storage. You can move selected or complete memory with graph-mind export FILE and graph-mind import FILE. A manual MCP setup exposes the tools, but it does not save every conversation automatically.
What it helps with
- recover a decision from an earlier session
- share context between Claude Code and Codex
- look up a past change in a project
- keep agent memory on a local computer
Example prompts for the agent
- Recall which database we chose for the billing service and why.
- Find what we changed in the authentication middleware last week.
- Use the saved project context when answering this question.
How to install Graph-MIND
Platform CLI
claude mcp add graph-mind -- uvx graph-mind-memoryuvx runs the command named after the package; if the README names another one, use uvx --from graph-mind-memory <command>
Platform CLI
codex mcp add graph-mind -- uvx graph-mind-memoryuvx runs the command named after the package; if the README names another one, use uvx --from graph-mind-memory <command>
Config file
{
"mcpServers": {
"graph-mind": {
"command": "uvx",
"args": [
"graph-mind-memory"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from graph-mind-memory <command>
Config file
{
"servers": {
"graph-mind": {
"type": "stdio",
"command": "uvx",
"args": [
"graph-mind-memory"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from graph-mind-memory <command>
Platform CLI
gemini mcp add graph-mind uvx graph-mind-memoryuvx runs the command named after the package; if the README names another one, use uvx --from graph-mind-memory <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Graph-MIND
How do I install Graph-MIND in Claude Code?
Run claude mcp add graph-mind -- uvx graph-mind-memory, then restart Claude Code.
What does Graph-MIND do?
It stores conversations on your computer and lets connected agents search earlier sessions. The same memory can be used across supported AI clients.
Does Graph-MIND require Python?
Python is not required for the installer. If Python is already available, you can use pip install graph-mind-memory && graph-mind-install.
