Skip to content
MCP server

recall

Share Claude Code's per-project memory with Codex, Cursor or any MCP client

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.3.0
Listing updated
today

Similar MCP servers

About recall

recall is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Claude Code saves corrections, preferences and project decisions as Markdown files with wiki-style links under its own projects folder, but only Claude Code reads them. recall finds the same directory using Claude Code's rules, reads every memory it wrote and writes files Claude Code reads back. Nothing is vectorized and no database is used; memories stay plain files.

The project is the git repository root, so subfolders share a memory and a worktree uses its main checkout's. Recalling a note follows its links to related notes within a token budget, and the tool list includes a check for memories old enough to re-confirm. A read-only flag lets another agent read without changing anything, and writes refuse credential-looking text unless you allow it.

It installs from npm and needs Node.js 18 or newer. The README shows Codex, Cursor, Cline and Gemini CLI setups, and the same package can be used from JavaScript code.

Install

Run in a terminal

claude mcp add recall -- npx -y @fainir/recall

Add to claude_desktop_config.json

{
  "mcpServers": {
    "recall": {
      "command": "npx",
      "args": [
        "-y",
        "@fainir/recall"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "recall": {
      "command": "npx",
      "args": [
        "-y",
        "@fainir/recall"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "recall": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@fainir/recall"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "recall": {
      "command": "npx",
      "args": [
        "-y",
        "@fainir/recall"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "recall": {
      "command": "npx",
      "args": [
        "-y",
        "@fainir/recall"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • RECALL_READ_ONLYSet to 1 to expose read-only tools

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

memory_list
List every memory with type and description
memory_get
Read one memory in full
memory_recall
Return named memories plus linked ones within a token budget
memory_due
List memories old enough to re-confirm
memory_write
Save or replace a memory and update the index
memory_delete
Delete a memory and its index line

What it does

Same memory folder
Locates the directory Claude Code uses for each project.
Link-following recall
Pulls named memories plus their linked notes within a token budget.
Read-only mode
A flag or environment variable hides the write tools.
Claude-compatible writes
Saves notes in Claude Code's format and updates the MEMORY.md index.
Stale memory check
Lists memories old enough to re-confirm.
Library use
Import it in JavaScript with Recall.forClaudeCode.

Good for

  • Let Codex see what Claude Code learned about a repo
  • Give Cursor the same project preferences
  • Review old memories before relying on them
  • Write notes that Claude Code reads next session

Pricing

Open source

Free npm package

recall FAQ

What does it need?

Node.js 18 or newer; run it with npx.

Can another agent change my memories?

Only if you leave off read-only; with the flag it exposes read tools.

Does it use a database?

No. Memories remain Markdown files.

Does it have dependencies?

The registry entry and README say zero dependencies.

Is recall free?

Yes. recall is open source, so you can use and self-host it for free.

How do I add recall to Claude Code?

Run this command in your terminal: claude mcp add recall -- npx -y @fainir/recall

What are the best alternatives to recall?

The closest alternatives to recall are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers