LocalKeep

Local memory banks you keep — a localhost Hub UI + MCP connector for Claude. You curate titled, dated memory banks on your machine; Claude recalls them via MCP.

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.

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).

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.