Connect in a dedicated practice workspace
Start an isolated Claude-Mem worker first, or use your existing local worker if you intend to save notes into its database. Use its actual URL. The default port is37700 + (uid % 100) unless CLAUDE_MEM_WORKER_PORT overrides it. Kilo does not start or configure the worker in this example.
Kilo reads project configuration from kilo.json. In a new practice directory, create this memory-only configuration, replacing the three absolute paths/URL values:
127.0.0.1 URL. For a worker with a separate data directory, also pass its CLAUDE_MEM_DATA_DIR in the MCP environment. Keep provider credentials outside shared project configuration. Configure your preferred model through Kilo’s supported provider setup; normal model use may incur charges. The fixture below instead uses a deterministic local endpoint and requires no account.
Save, search and inspect
From the practice directory, run Kilo with your configured model:claudemem_search for restore snapshots with project memory-practice. Check that the returned index contains the saved ID and title. Then ask claudemem_get_observations for that selected ID with the same project and verify the exact text.
The project is a query/write scope, not a multi-user authorization boundary. This trusted local MCP server can expose the worker owner’s data. Only connect it to clients you trust. Explicit MCP saves honor CLAUDE_MEM_EXCLUDED_PROJECTS: a save_memory call from an excluded checkout is skipped and answers “Not saved: this checkout is excluded by CLAUDE_MEM_EXCLUDED_PROJECTS.” (#6105, in the release after 15.18.5).
A final assistant sentence is not proof of a successful operation. Inspect the actual tool result for saved receipts or errors. There is no automatic replay added by this connection. Retrying an explicit save manually is a new operation unless the existing worker deduplication recognizes it.
Repeatable verification
From a Claude-Mem checkout with current bundles built and Kilo 7.8.27 installed:Disconnect and troubleshooting
Remove onlymcp.claudemem and its three permission.claudemem_* entries from the practice configuration, preserving unrelated settings. Restart the Kilo session. Saved worker memories remain. No Claude Code or Codex settings are modified.
If MCP fails to connect, verify the executable paths and worker URL. If a tool is unavailable, check the server name and matching permission key. A denied tool should not return memory content. If the worker stops, memory calls should return an error rather than a successful save or recall.
