State Memory MCP — Claude Code MCP server: install and overview
Persistent SQLite graph that records tasks and architectural choices across coding sessions. Keeps agent context local without extra LLM calls.
claude mcp add state-memory-mcp -- npx -y @putervision/state-memory-mcpWhat State Memory MCP does
The server stores project workflow state directly into a local SQLite database using WAL mode inside .state-memory-mcp/. Instead of rescanning workspace files on every turn, coding assistants query tasks and blocker dependencies via 13 dedicated MCP tools such as manage_tasks and query_graph.
Graph operations remain fully deterministic. Data mutations run directly without invoking secondary neural network calls. The toolkit includes DAG cycle detection, FTS5 full-text search, snapshot restoration, and an asynchronous blackboard tool for coordinating multi-agent workflows. Running the package requires Node.js version 18.18.0 or newer; execution fails without it.
What it helps with
- preserve architectural decisions and blocker states across agent sessions
- trace task dependencies using a directed acyclic graph
- prevent context bloat by moving workflow state into local SQLite storage
- coordinate task assignments across parallel subagents using a shared board
Example prompts for the agent
- Record our auth refactoring decision and add its dependency links to the graph
- Show all active blockers and fetch the next unblocked task from the queue
- Take a state snapshot of the current workflow before starting database migration
How to install State Memory MCP
Platform CLI
claude mcp add state-memory-mcp -- npx -y @putervision/state-memory-mcpPlatform CLI
codex mcp add state-memory-mcp -- npx -y @putervision/state-memory-mcpConfig file
{
"mcpServers": {
"state-memory-mcp": {
"command": "npx",
"args": [
"-y",
"@putervision/state-memory-mcp"
]
}
}
}Config file
{
"servers": {
"state-memory-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@putervision/state-memory-mcp"
]
}
}
}Platform CLI
gemini mcp add state-memory-mcp npx -y @putervision/state-memory-mcpStep 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 State Memory MCP
How to install State Memory MCP in Claude Code?
Run claude mcp add state-memory-mcp -- npx -y @putervision/state-memory-mcp in your terminal. Restart Claude Code to complete the setup.
What does State Memory MCP do?
It maintains a local workflow graph storing tasks, decisions, and dependencies in SQLite. AI assistants use it to look up project context without parsing files repeatedly.
Does State Memory MCP send workflow state to external servers?
No, all graph files remain strictly inside your workspace under .state-memory-mcp/. The server runs locally and needs no external network database.
