Pensieve Docs
Docs menu

Connect your agent

Pensieve for Cursor

This page tells you how to connect Cursor to Pensieve over MCP, and what changes on your computer.

Connect Cursor

  1. Install Pensieve (see Install).
  2. Run one of these commands:
    pensieve integrate recommended   # every agent on this computer
    pensieve integrate cursor-mcp pensieve-search   # only Cursor
  3. Restart Cursor. It loads its MCP servers when it starts.
  4. Ask Cursor a question about your code, for example “where do we retry failed webhooks?”.

What Pensieve adds

Add-onIdFile
MCP servercursor-mcp~/.cursor/mcp.json
Skillspensieve-search~/.agents/skills

Cursor has no global instructions file that Pensieve writes to. Copy the instructions block into the rules of Cursor. It tells the agent to call search before it greps.

Connect by hand

Add this entry to ~/.cursor/mcp.json. Use the full path of your pensieve command. To find it, run which pensieve.

{
  "mcpServers": {
    "pensieve": {
      "command": "/Users/you/.local/bin/pensieve",
      "args": ["mcp"]
    }
  }
}

Remove

pensieve integrate cursor-mcp --remove

Pensieve removes only the entries that it added.

See also: scopes, the MCP tools, and the benchmark.

Something wrong or missing? Tell us on GitHub.