# Unforget MCP Server

Long-term memory for Claude Code, Cursor, and any MCP client. Zero LLM on write. Zero config.

## Install

```bash
pipx install unforget-mcp
```

## Setup

### Claude Code

Add to your project's `.mcp.json` or global settings:

```json
{
  "mcpServers": {
    "unforget": {
      "command": "unforget-mcp",
      "args": []
    }
  }
}
```

### Cursor

Add to Cursor settings → MCP Servers:

```json
{
  "mcpServers": {
    "unforget": {
      "command": "unforget-mcp",
      "args": []
    }
  }
}
```

### VS Code (Copilot)

Add to `.vscode/mcp.json`:

```json
{
  "mcpServers": {
    "unforget": {
      "command": "unforget-mcp",
      "args": []
    }
  }
}
```

That's it. No API keys, no Docker, no database setup. An embedded PostgreSQL starts automatically.

## Tools

| Tool | Description |
|------|-------------|
| `memory_store` | Store a fact, preference, or decision |
| `memory_search` | Search memories with 4-channel retrieval |
| `memory_forget` | Delete memories by query or ID |
| `memory_list` | List all stored memories |
| `memory_update` | Update a memory (preserves history) |

## Options

```bash
# Embedded mode (default — auto-starts PostgreSQL)
unforget-mcp

# External database
unforget-mcp --database-url postgresql://user:pass@localhost/db

# Custom scoping
unforget-mcp --org-id myorg --agent-id myagent

# SSE transport (for remote connections)
unforget-mcp --transport sse --port 8767
```

## How It Works

```
Claude Code / Cursor / MCP Client
    │ MCP protocol (stdio or SSE)
    ▼
unforget-mcp server
    ├── unforget core (4-channel retrieval, embedder, reranker)
    └── pgserver (embedded PostgreSQL + pgvector)
```

- Memories persist in `~/.unforget/mcp-data/`
- 4-channel retrieval: semantic + BM25 + entity + temporal
- Cross-encoder reranking for accuracy
- Zero LLM calls on write (~7ms per memory)

## License

Apache 2.0