RepoMemory MCP server
dev.repomemory · Updated
Shared project memory for coding agents: decisions, lessons, guardrails and tasks per repository.
At a glance
RepoMemory is an MCP server in the AI & Memory category. It is hosted remotely and connects over HTTP, and needs X-API-Key. It exposes 5 tools, including record_entry, recall and brief. It scores C (40/100) on the MCP Skills Hub health score as of Oct 28, 2026.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install RepoMemory in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install RepoMemory in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add --transport http repomemory https://api.repomemory.dev/mcp --header 'X-API-Key: <X-API-KEY>'Fill in your credentials
Replace <X-API-KEY> with your real value. Keep secrets out of any config file you commit.
Verify it's connected
bashclaude mcp listSharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. record_entry, recall, brief). It discovers them automatically.
How to install RepoMemory in Claude DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this server
json{ "mcpServers": { "repomemory": { "command": "npx", "args": [ "-y", "mcp-remote", "https://api.repomemory.dev/mcp", "--header", "X-API-Key:${X_API_KEY}" ], "env": { "X_API_KEY": "<X-API-KEY>" } } } }Fill in your credentials
Replace <X-API-KEY> with your real value. Keep secrets out of any config file you commit.
Why the wrapper?
This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install RepoMemory in CursorAI-first code editor
Create / edit .cursor/mcp.json in your project
json{ "mcpServers": { "repomemory": { "url": "https://api.repomemory.dev/mcp", "headers": { "X-API-Key": "<X-API-KEY>" } } } }Fill in your credentials
Replace <X-API-KEY> with your real value. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install RepoMemory in Codex CLIOpenAI coding agent
Add to ~/.codex/config.toml
toml[mcp_servers.repomemory] command = "npx" args = ["-y", "mcp-remote", "https://api.repomemory.dev/mcp", "--header", "X-API-Key:${X_API_KEY}"] env = { X_API_KEY = "<X-API-KEY>" }Fill in your credentials
Replace <X-API-KEY> with your real value. Keep secrets out of any config file you commit.
Why the wrapper?
Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install RepoMemory in WindsurfCodeium's agentic IDE
Edit ~/.codeium/windsurf/mcp_config.json
json{ "mcpServers": { "repomemory": { "serverUrl": "https://api.repomemory.dev/mcp", "headers": { "X-API-Key": "<X-API-KEY>" } } } }Fill in your credentials
Replace <X-API-KEY> with your real value. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install RepoMemory in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
Add the server
json{ "mcpServers": { "repomemory": { "type": "streamableHttp", "url": "https://api.repomemory.dev/mcp", "headers": { "X-API-Key": "<X-API-KEY>" } } } }Fill in your credentials
Replace <X-API-KEY> with your real value. Keep secrets out of any config file you commit.
How to install RepoMemory in VS CodeCopilot / MCP support
Create .vscode/mcp.json
json{ "servers": { "repomemory": { "type": "http", "url": "https://api.repomemory.dev/mcp", "headers": { "X-API-Key": "<X-API-KEY>" } } } }Fill in your credentials
Replace <X-API-KEY> with your real value. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What does RepoMemory need from you?
API key — Your RepoMemory API key (create one at https://repomemory.dev/dashboard/keys); clients usually read it from the REPOMEMORY_KEY environment variable.
X-API-KeyrequiredsecretHTTP headerYour RepoMemory API key (create one at https://repomemory.dev/dashboard/keys); clients usually read it from the REPOMEMORY_KEY environment variable.
What tools does RepoMemory expose? (5)
Read from the live server. Click any tool for its input schema.
- record_entryWrite down something the next agent or teammate on this project must know: a decision and why it was made, a lesson from something that broke or was reverted, a guardrail (a rule not to break), a note, or a task to be done. Record a lesson whenever a change is rolled back or a fix took real digging, and a decision whenever an approach is chosen over another. `kind` is decision, lesson, guardrail,
- recallBefore planning a change, removing code that looks unnecessary, or repeating an approach, search the project's ledger for what was already decided, tried or forbidden. Put the area or change in `query`: any of its words match, best matches first, and a word in an entry's title counts for more than one in its body. Use the words that would appear in the entry, not the words of the symptom: 'captcha
- briefCall this first, at the start of a session, before planning any change. It returns every active guardrail (rules not to break, each with its title and the start of its reasoning, rather than left to a word match), the open and claimed tasks, and the titles of the newest decisions, lessons and notes, so you start where the last session stopped. Bodies are cut short to keep it small: recall with an
- claim_taskTake a task before starting it, so another agent or teammate doesn't work on the same one. Give the task's `id` (TASK-n), or leave it out to take the oldest open task. `agent` names who is working on it ("claude-code on dimaino's laptop"). It returns a `claim_token`: keep it. A task claimed by anyone else, even a session with your own name, is refused with already_claimed; claiming again with your
- retire_entryRetire a decision, lesson, guardrail or note that is no longer true, so recall stops returning it, or mark a task done. Give its `id` and, for anything but a finished task, a short `reason`. To replace an entry with a new one, use record_entry with `supersedes` instead. Retiring again changes nothing. Free. Returns the entry with its new status. Free to call.
What the code can do
This is a remote server — nothing is installed or run on your machine, so there is no local code to analyze. What it can reach is described above: your requests go to the provider's host.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Third-party hosted service — Your requests and any data in them are sent to api.repomemory.dev.
- No local execution — Nothing is installed or run on your machine.
- No source repository — This registry entry does not link to a public repo, so its code cannot be reviewed before you install it.
Client compatibility
Health score
C · 40Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%not measurable
No commit history available.
- Adoption20%not measurable
No usage data available.
- Transparency20%25%
1/4: ✗ public source repo, ✗ declared license, ✗ documentation, ✓ discoverable tool list.
- Provenance15%0%
No source repository to trace the code back to.
- Packaging15%100%
Remote endpoint with documented authentication.
Alternatives to RepoMemory
- Atlaso MemoryB · 68Atlaso, the AI memory layer: one shared, persistent memory for every AI tool you connect.
- MemoryPilotB · 76Long-term memory for AI agents: fast recall, project brains and skills, local, in one binary.
- Assertion MemoryB · 78Recall your team's coding-agent memory. Install the Assertion plugin to capture it automatically.
- Apiary MemoryB · 76Local-first memory over MCP. Built-in SQLite store; runs standalone. Agents propose; you confirm.
Maintain RepoMemory? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/dev-repomemory-repomemory)Catalog data refreshed . Something wrong? Report it.