LocalKeep

Local memory banks you keep — a Hub UI + MCP connector for Claude Desktop / Cowork. You curate titled, dated memory banks in the browser; Claude recalls them via MCP.

Not affiliated with Vectorize Hindsight.

Install

pip install localkeep
# or: uv tool install localkeep

Then:

localkeep-hub          # http://127.0.0.1:8000

In Claude Desktop, register the MCP server (claude_desktop_config.json):

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

If the GUI can’t find localkeep-mcp on your PATH, use the absolute path from which localkeep-mcp (the Hub’s Connect panel copies this for you).

Memories default to ~/.localkeep/localkeep.db when installed via pip. Override with LOCALKEEP_DATA_DIR or LOCALKEEP_DB_PATH.

Auto-use LocalKeep (important)

Claude will not reliably call MCP tools unless you also set Personal preferences:

1. Claude Desktop → Settings → Profile → Personal preferences
2. Paste the LocalKeep instructions (Hub → Connect → Copy instructions, or see src/localkeep/assets/claude-personal-preferences.txt)
3. Quit Claude completely and reopen
4. When LocalKeep asks to run a tool, click Always approve

Develop from source

git clone https://github.com/zuneracodes/localkeep
cd localkeep
uv sync --group dev
uv run localkeep-hub                     # http://127.0.0.1:8000
# optional live reload:
LOCALKEEP_HUB_RELOAD=1 uv run localkeep-hub

From a source checkout, the DB lives in data/localkeep.db.

Optional demo seed (skips manual Hub entry):

uv run python scripts/seed_demo.py

Hub UI (Win95 / Paint homage)

The Hub is intentionally retro: Windows 95 / MS Paint–inspired window chrome (toolbox, title bar, white canvas, status bar) — a “punk software” contrast with modern GenAI tooling.

• Desk / Title / Window / Canvas color pickers in the status bar → any hex via the system color chooser
• Theme is stored in browser localStorage only (not in the SQLite DB)
• Privacy line on every page: Memories stay on this device.
• Homage UI only — no Microsoft logos, trademarks, or ripped OS icons

Tests

uv sync --group dev
uv run pytest

Tests start from an empty DB and create memories through Hub form POSTs (same path as a new user). Optional seed_demo.py is for live demos only.

Privacy

All memory data stays in your chosen local DB path (~/.localkeep/ for pip installs, or data/localkeep.db in a checkout). Nothing is sent to a LocalKeep cloud — there isn’t one. Theme colors never leave the browser.

License

MIT — see LICENSE.