Skip to main content
Docs
Install guide~60s total

Install Ricord in Cursor

Three 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).
  • bun on your PATH (install Bun if you don't have it).
  • A Ricord account — sign up first if you don't have one.

Step 1 — Install the Ricord CLI

bun add -g ricord

Verify:

ricord --version
# → ricord vX.Y.Z

Step 2 — Log in

ricord login

Sign in via the browser tab. The CLI stores your API key in the OS keychain.

Step 3 — Wire into Cursor

ricord install

For Cursor, this 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 4 — 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 5 — 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 bun globally in zsh but Cursor was launched from Finder, it may not have the bun global bin dir. 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.

Same install, other clients

The Ricord CLI auto-detects Claude Desktop, Claude Code, and Codex if you also have them installed. ricord install 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.