# memoir

An MCP server that stores decisions, goals and next steps in local project files. Switch between tools or machines without losing context.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Author: camgitt
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/camgitt/memoir
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/memoir

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

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add memoir -- npx -y memoir-cli
```

### Codex

**Platform CLI**
```bash
codex mcp add memoir -- npx -y memoir-cli
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "memoir": {
            "command": "npx",
            "args": [
                "-y",
                "memoir-cli"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "memoir": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "memoir-cli"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add memoir npx -y memoir-cli
```

## When to use it
- 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
- 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

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md