Install Ricord in Cursor
Two commands, one MCP config block, and a Composer smoke test. Persistent memory wired into Cursor in under 60 seconds — same memory follows you across projects.
Prerequisites
- Cursor 0.43 or later (MCP support shipped Sep 2024; current builds all support it).
- Node.js ≥ 18 with npm on your PATH.
- A Ricord account — sign up first if you don't have one.
Step 1 — Install the Ricord CLI
npm install -g ricord
Verify:
ricord --version # → ricord vX.Y.Z
Step 2 — Set up Ricord
ricord setup
setup signs you in via the browser (the CLI stores your API key in the OS keychain), scans your history for preferences, then auto-detects installed AI clients and wires each one. For Cursor, it writes to:
- Global (all projects):
~/.cursor/mcp.json
If you prefer per-project MCP servers (some teams scope memory to a single repo), create .cursor/mcp.json at the project root with the same block — Cursor merges per-project entries with global ones at runtime.
The block added looks like this:
{
"mcpServers": {
"ricord": {
"command": "ricord",
"args": ["mcp"]
}
}
}Existing MCP servers in ~/.cursor/mcp.json are left untouched.
Step 3 — Restart Cursor
Cmd-Q + reopen, not just close-the-window. Cursor only loads MCP servers at process startup.
Confirm the server is loaded: Cmd-, → Cursor Settings → Features → MCP. You should see ricordin the list with a green dot. If it's red, click Show logs and check for startup errors.
Step 4 — Smoke test in Composer
Open Composer (Cmd-I on macOS) and type:
Remember that this project deploys via ./deploy.sh.
Cursor calls ricord_save. You'll see the tool call in the chat.
Open a new Composer chat (or restart Cursor to be extra-sure). Type:
How do I deploy this project?
Cursor calls ricord_recall and answers with ./deploy.sh. The install is good.
What to expect over the next week
- Day 1: Cursor saves and recalls when you ask explicitly.
- Day 3: Cursor starts calling
ricord_get_contextproactively when you open a new project — pulling in what it learned in adjacent ones. - Day 7: Open the dashboard — wiki pages per project, backlinks between entities you've discussed.
Troubleshooting
MCP Settings shows ricord as red. Click Show logs. The two common errors:
command not found: ricord— Cursor can't find the CLI on its PATH. Cursor inherits PATH from the shell that launched it; if you installed Node.js/npm globally but Cursor was launched from Finder, it may not have the npm global bin dir in PATH. Restart Cursor from a terminal:open -a Cursor.- Auth errors — re-run
ricord login.
Composer never calls the tool. Make sure your agent setting allows tool use — Cmd-, → Features → Agent → Tools. Memory tools must be checked.
You see the wiki dashboard but it's empty. Background indexing runs every ~10 minutes. Pages appear after the first batch.
Optional: build a wiki for this repo
After a few sessions, run this from any repo root to generate a structured wiki from everything Ricord has learned:
ricord build
The result appears in the dashboard — one wiki page per entity your sessions have touched.
Same setup, other clients
The Ricord CLI auto-detects Claude Desktop, Claude Code, and Codex if you also have them installed. ricord setup wires them all to the same memory. Switch between Cursor and Claude Desktop on the same project — both clients see the same wiki, the same recalled facts.