Unforget MCP Server
Long-term memory for Claude Code, Cursor, and any MCP client. Zero LLM on write. Zero config.
Install
pipx install unforget-mcpSetup
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 8767How 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
