# mindpm

mindpm — an MCP server that stores tasks, decisions and project context in SQLite. Every new conversation picks up where the last one left off.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 repo stars
- Author: umitkavala
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/umitkavala/mindpm
- Updated: 2026-10-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/mindpm

## What it does

mindpm writes project state to a local SQLite database: tasks with priorities and blockers, accepted decisions and rejected alternatives, architecture notes, session summaries and agent attempts. The LLM calls `start_session` to load context, adds new records as you work, and saves the next-session plan via `end_session`. A Kanban board at `localhost:3131` displays tasks and lets you accept agent work.

The server can hand specced tasks to autonomous agents: a claim mechanism with leases prevents parallel agents from working on the same task, and you accept results manually on the board. For unattended agents, an optional verifier reruns checks before counting a commit as done. All data stays on your machine in a single `~/.mindpm/memory.db` file.

No user accounts, no write protection — an agent with shell access can bypass the board and write to the database directly. Review the security model in the docs before running agents unattended.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `MINDPM_DB_PATH`, `MINDPM_PORT`, `MINDPM_HOST` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MINDPM_DB_PATH=<MINDPM_DB_PATH> --env MINDPM_PORT=<MINDPM_PORT> --env MINDPM_HOST=<MINDPM_HOST> --transport stdio mindpm -- npx -y mindpm
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mindpm --env MINDPM_DB_PATH=<MINDPM_DB_PATH> --env MINDPM_PORT=<MINDPM_PORT> --env MINDPM_HOST=<MINDPM_HOST> -- npx -y mindpm
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mindpm": {
            "command": "npx",
            "args": [
                "-y",
                "mindpm"
            ],
            "env": {
                "MINDPM_DB_PATH": "<MINDPM_DB_PATH>",
                "MINDPM_PORT": "<MINDPM_PORT>",
                "MINDPM_HOST": "<MINDPM_HOST>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mindpm": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mindpm"
            ],
            "env": {
                "MINDPM_DB_PATH": "<MINDPM_DB_PATH>",
                "MINDPM_PORT": "<MINDPM_PORT>",
                "MINDPM_HOST": "<MINDPM_HOST>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MINDPM_DB_PATH=<MINDPM_DB_PATH> -e MINDPM_PORT=<MINDPM_PORT> -e MINDPM_HOST=<MINDPM_HOST> mindpm npx -y mindpm
```
Replace <…> with your own values

## When to use it
- preserve project context between sessions in Claude Code
- hand a specced task to an agent without chat history
- stop two agents from working on the same task at once
- run a Kanban board of tasks and accept agent work
- rerun checks before counting an unattended agent's commit as done

## Example prompts
- Show high-priority tasks from mindpm
- Save the decision to use Redis for session cache in mindpm
- Write the session summary and next-session plan to mindpm

## Similar
- [ak-plan](https://affpapa.org/en/nevibecode/skills/ak-plan.md) — skill · 139 installs
- [Kanzo](https://affpapa.org/en/nevibecode/mcp/kanzo.md) — MCP server · ★ 1305 repo stars
- [KittyClaw](https://affpapa.org/en/nevibecode/mcp/kittyclaw.md) — MCP server · ★ 31 repo stars
- [Fjord](https://affpapa.org/en/nevibecode/mcp/fjord.md) — MCP server · ★ 5 repo stars
- [Agent Swarm](https://affpapa.org/en/nevibecode/mcp/agent-swarm.md) — MCP server · ★ 1097 repo stars
- [obsidian-bases](https://affpapa.org/en/nevibecode/skills/obsidianmd-obsidian-bases.md) — skill · 84200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
