Skip to main content
All install guides
Install guide~60s total

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_context proactively 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.