mushroomdb — Claude Code MCP server for graph memory
mushroomdb stores entities and derives their links from rules. Connect it when an agent needs to remember facts and explain how items relate.
claude mcp add mushroomdb -- npx -y mushroomdbWhat mushroomdb does
mushroomdb gives an agent MCP access to a graph database stored on disk. The agent can save facts, retrieve or remove them, explain why two entities connect, and inspect links from an earlier date or Git commit. You define relationship rules, such as matching a property or checking how lists overlap. When entity properties change, the database recalculates affected links and removes ones that no longer qualify.
Queries can also preview the links a change would add or remove, and access can vary by caller role. Vector rules require embeddings that you supply. The working graph stays in memory, only one writer can operate at a time, and interactive transactions are unsupported. That rules out projects that depend on concurrent writers or interactive transaction workflows.
What it helps with
- store facts about entities for an agent
- derive graph links from declared rules
- find the rule and evidence behind a connection
- preview a property change before saving it
Example prompts for the agent
- Remember that project Atlas uses PostgreSQL.
- Find the saved facts about project Atlas.
- Explain why these two entities are connected.
How to install mushroomdb
Platform CLI
claude mcp add mushroomdb -- npx -y mushroomdbPlatform CLI
codex mcp add mushroomdb -- npx -y mushroomdbConfig file
{
"mcpServers": {
"mushroomdb": {
"command": "npx",
"args": [
"-y",
"mushroomdb"
]
}
}
}Config file
{
"servers": {
"mushroomdb": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mushroomdb"
]
}
}
}Platform CLI
gemini mcp add mushroomdb npx -y mushroomdbStep 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 mushroomdb
How do I install mushroomdb in Claude Code?
Run claude mcp add mushroomdb -- npx -y mushroomdb to add mushroomdb as an MCP server.
What does mushroomdb do?
It gives agents access to a graph database where rules determine links between entities. Agents can store and retrieve facts, inspect past links, and ask for the basis of a relationship.
Do vector rules include embeddings?
No. You need to provide the embeddings used by vector rules.
