# State Memory MCP (MCP server)

> State Memory MCP is an MCP server that adds database tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Persistent workflow graph server tracking tasks, decisions, spatial entities, and blockers. It has 111 GitHub stars, is released under the MIT license and runs locally with npx -y @putervision/state-memory-mcp.

@putervision/state-memory-mcp is a zero-infrastructure, deterministic Model Context Protocol (MCP) server that provides AI coding assistants (such as Cursor, Claude Code, Gemini, or Copilot) with a structured, persistent SQLite graph for tracking workflow state—tasks, decisions, artifacts, plans, blockers, and their semantic relationships.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/putervision/state-memory-mcp |
| GitHub stars | 111 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @putervision/state-memory-mcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Databases |
| Latest release | v1.4.1 (Oct 3, 2026) |
| Last commit | Oct 3, 2026 |
| MCP registry name | io.github.putervision/state-memory-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "state-memory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@putervision/state-memory-mcp"
      ]
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio state-memory-mcp -- npx -y @putervision/state-memory-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "state-memory-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@putervision/state-memory-mcp"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "state-memory-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@putervision/state-memory-mcp"
      ]
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Similar MCP servers

- [Dbx](https://appsgit.com/mcp-servers/dbx): Query databases from AI agents using connections configured in DBX. (24,945 stars, Apache-2.0)
- [Butterbase AI MCP Server](https://appsgit.com/mcp-servers/butterbase-ai-mcp-server): Butterbase MCP server — manage your backend: schemas, auth, functions, storage, RAG, deploys. (3,686 stars, Apache-2.0, needs API key)
- [DBHub](https://appsgit.com/mcp-servers/dbhub): Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite. (3,610 stars, MIT, needs API key)
- [LINQ to DB](https://appsgit.com/mcp-servers/linq-to-db): Inspect database schemas and execute SQL queries across multiple database providers with LINQ to DB. (3,332 stars, MIT)
- [Mindwtr](https://appsgit.com/mcp-servers/mindwtr): Task automation via SQLite, desktop Local API, or Mindwtr Cloud; read-only by default. (2,211 stars, AGPL-3.0, needs API key)
- [MCP Memory Service](https://appsgit.com/mcp-servers/mcp-memory-service): Open-source persistent memory for AI agent pipelines (LangGraph, CrewAI, AutoGen) and Claude. (1,988 stars, Apache-2.0)

---

Canonical page: https://appsgit.com/mcp-servers/state-memory-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.