# recall

> recall is an open-source MCP server for knowledge and memory. Share Claude Code's per-project memory with Codex, Cursor or any MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/fainir/recall
- **MCP Registry name:** io.github.fainir/recall
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/recall-6
