recall
Share Claude Code's per-project memory with Codex, Cursor or any MCP client
- 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/recallAdd to claude_desktop_config.json
{
"mcpServers": {
"recall": {
"command": "npx",
"args": [
"-y",
"@fainir/recall"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"recall": {
"command": "npx",
"args": [
"-y",
"@fainir/recall"
]
}
}
}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.


