Unforget MCP Server

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

Install

pipx install unforget-mcp --python python3.12

Setup

Claude Code

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

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

Cursor

Add to Cursor settings → MCP Servers:

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

VS Code (Copilot)

Add to .vscode/mcp.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

# 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