memoir — Claude Code MCP server: project memory across sessions
An MCP server that stores decisions, goals and next steps in local project files. Switch between tools or machines without losing context.
claude mcp add memoir -- npx -y memoir-cliWhat memoir does
Memoir saves decisions, rationale, goals and check results to your project in .memoir/ files. These files stay local and do not sync to GitHub. When you return to the project, the agent can recall what has been decided and what was already verified.
Continue a project between Claude Code and Cursor on the same machine: open the same folder and branch, tell the agent to pick up where you left off, and it retrieves the saved context through MCP. You can also create an encrypted backup and restore it on another machine when needed. Node.js 18 or later is required.
Memory runs entirely on your machine. Installing the server through npm does not upload project data anywhere. Use the CLI—memoir work check, memoir work view, and recovery commands like memoir work doctor—to manage what is stored.
What it helps with
- recall decisions and their reasoning across agent sessions
- hand off project context from Claude Code to Cursor
- restore project memory on a different machine
- track which checks have already been run
- search saved notes and answers
Example prompts for the agent
- Set up memoir so I remember this project next time
- Open this project in Cursor and I'll load the decisions and next steps from here
- Show me what we recorded about recovery codes
How to install memoir
Platform CLI
claude mcp add memoir -- npx -y memoir-cliPlatform CLI
codex mcp add memoir -- npx -y memoir-cliConfig file
{
"mcpServers": {
"memoir": {
"command": "npx",
"args": [
"-y",
"memoir-cli"
]
}
}
}Config file
{
"servers": {
"memoir": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"memoir-cli"
]
}
}
}Platform CLI
gemini mcp add memoir npx -y memoir-cliStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about memoir
How do I install memoir in Claude Code?
Run claude mcp add memoir -- npx -y memoir-cli. Then restart Claude Code and accept the MCP connection prompt.
What does memoir do?
It stores decisions, goals and check results in local project files. When you open the project again, the agent can retrieve that context. You can also move memory between Claude Code and Cursor on the same machine.
Where is my project data stored?
In the .memoir/ folder inside your project. These files do not sync to GitHub. You can create an encrypted backup with memoir work backup and restore it on another machine.
