Cline
Connect Rekall to Cline (the VS Code autonomous coding agent) via MCP. Cline gains persistent memory across tasks — it remembers your codebase patterns, decisions, and preferences instead of starting from scratch each session.
Overview
Cline supports MCP servers natively through its settings. Once Rekall is registered, Cline's 40+ memory tools become available to the agent — creating memories, semantic search, entities, workflows, execution state, and more.
Rekall must be running locally
The MCP server connects to your running Rekall backend. Make sure the databases and API are up (docker-compose ps and curl http://localhost:9876/health returns healthy) before launching Cline.
Prerequisites
- check_circleVS Code with the Cline extension installed
- check_circleA local Rekall checkout with the
start-mcp.shlaunch script - check_circleNode.js 18+ (the script runs the MCP server with
npx tsx)
Step 1: Locate the Config File
Cline stores MCP server settings in cline_mcp_settings.json. You can open it from the Cline panel (the MCP Servers icon → Configure MCP Servers), or edit it directly:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Step 2: Add the Rekall Server
Add a rekall entry under mcpServers. The launch command runs Rekall's start-mcp.sh script via bash — use the absolute path to the script in your checkout:
{"mcpServers": {"rekall": {"command": "/bin/bash","args": ["/absolute/path/to/rekall/start-mcp.sh"],"env": {"REKALL_USER_ID": "your_user_id","WORKSPACE": "work"}}}}
Use an absolute path
Cline launches the server from its own working directory, so a relative path like ~/rekall/start-mcp.sh will fail. Point args at the fully-qualified path to start-mcp.sh in your Rekall checkout.
Step 3: Verify the Connection
Save the file. Cline reloads MCP settings automatically; open the MCP Servers panel and confirm rekall shows a green connected indicator with its tools listed. You can also ask Cline directly:
You: "Do you have access to Rekall memory tools?"Cline: "Yes — the rekall MCP server is connected. I can create and searchmemories, manage entities and workflows, and read agent context."
Using Memory in Cline
Ask Cline to remember decisions as it works, and it will recall them on future tasks in the same workspace:
You: "Remember that this repo uses pnpm, not npm, and all tests run with vitest."Cline: [stores a semantic memory] "Noted — I'll use pnpm and vitest going forward."--- later, new task ---You: "Add a test for the new parser."Cline: [recalls memory] "I'll add a vitest test and run it with pnpm, matchingthis repo's conventions."
Troubleshooting
Server fails to start
Run /bin/bash /absolute/path/to/rekall/start-mcp.sh in a terminal. It should print "Rekall MCP server running on stdio". Fix any errors there before retrying in Cline.
Connection refused
Ensure the Rekall backend is running and reachable at http://localhost:9876/health. Start the databases with docker-compose up -d.
