Zed
Connect Rekall to Zed's Assistant via MCP (Zed calls them "context servers"). Your AI panel gains persistent memory — it remembers your codebase patterns, decisions, and preferences across sessions.
Overview
Zed supports MCP servers as context servers, configured under context_servers in your Zed settings. Once Rekall is registered, its 40+ memory tools become available to the Assistant — 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 Zed.
Prerequisites
- check_circleZed installed with the Assistant configured
- 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: Open settings.json
Zed stores context-server configuration in its main settings file. Open it from the command palette (cmd-shift-p → zed: open settings), or edit it directly:
~/.config/zed/settings.json
Step 2: Add the Rekall Server
Add a rekall entry under context_servers. Rekall ships as a custom (stdio) server launched via start-mcp.sh — use the absolute path to the script in your checkout:
{"context_servers": {"rekall": {"source": "custom","command": "/bin/bash","args": ["/absolute/path/to/rekall/start-mcp.sh"],"env": {"REKALL_USER_ID": "your_user_id","WORKSPACE": "work"}}}}
Use an absolute path
Zed 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. Zed picks up the context server automatically; open the Assistant panel and confirm rekall appears as a connected context server with its tools available. You can also ask the Assistant directly:
You: "Do you have access to Rekall memory tools?"Assistant: "Yes — the rekall context server is connected. I can create and searchmemories, manage entities and workflows, and read agent context."
Using Memory in Zed
Ask the Assistant to remember decisions as you work, and it will recall them in future sessions on the same project:
You: "Remember that this repo uses pnpm, not npm, and all tests run with vitest."Assistant: [stores a semantic memory] "Noted — I'll use pnpm and vitest going forward."--- later, new session ---You: "Add a test for the new parser."Assistant: [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 Zed.
Connection refused
Ensure the Rekall backend is running and reachable at http://localhost:9876/health. Start the databases with docker-compose up -d.
Context server not listed
Confirm the entry is under context_servers (not mcpServers) and includes "source": "custom". Reopen the settings file to check the JSON is valid.
