# Magnemo

Stores agent memory in local markdown files under your supervision. It makes zero network calls and writes facts only after you approve them.

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

## What it does

Magnemo keeps agent notes on your hard drive in a folder of markdown files. When an assistant learns a project detail, the entry sits in staging until you confirm it in chat. Nothing saves without your explicit consent. Each record logs both the creator and the reviewer in file headers and an append-only ledger.

The server runs without external model requests or vector embeddings. It relies on keyword search, so semantic matching is absent. Python 3.11 or newer is required to execute the tool. Deleted items are never discarded outright: rejected ideas keep refusal notes, while superseded entries move into an archive with pointers to current versions.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `MAGNEMO_VAULT`, `MAGNEMO_AGENT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MAGNEMO_VAULT=<MAGNEMO_VAULT> --env MAGNEMO_AGENT=<MAGNEMO_AGENT> --transport stdio magnemo -- uvx magnemo-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from magnemo-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add magnemo --env MAGNEMO_VAULT=<MAGNEMO_VAULT> --env MAGNEMO_AGENT=<MAGNEMO_AGENT> -- uvx magnemo-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from magnemo-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "magnemo": {
            "command": "uvx",
            "args": [
                "magnemo-mcp"
            ],
            "env": {
                "MAGNEMO_VAULT": "<MAGNEMO_VAULT>",
                "MAGNEMO_AGENT": "<MAGNEMO_AGENT>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from magnemo-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "magnemo": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "magnemo-mcp"
            ],
            "env": {
                "MAGNEMO_VAULT": "<MAGNEMO_VAULT>",
                "MAGNEMO_AGENT": "<MAGNEMO_AGENT>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from magnemo-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MAGNEMO_VAULT=<MAGNEMO_VAULT> -e MAGNEMO_AGENT=<MAGNEMO_AGENT> magnemo uvx magnemo-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from magnemo-mcp <command>

## When to use it
- keep project context in local markdown files
- approve or reject agent memory entries directly in chat
- inspect author and approver details for every saved fact
- maintain long-term memory without making external API calls

## Example prompts
- Use Magnemo to remember what this project is
- Check what you remember about our database setup
- Store the deployment procedure in Magnemo

## Similar
- [Mnemosyne OS](https://affpapa.org/en/nevibecode/mcp/mnemosyne-os.md) — MCP server · ★ 20
- [mindmap-mcp-server](https://affpapa.org/en/nevibecode/mcp/mindmap-mcp-server.md) — MCP server · ★ 6
- [SuperLocalMemory](https://affpapa.org/en/nevibecode/mcp/superlocalmemory.md) — MCP server · ★ 263
- [OMEGA Memory](https://affpapa.org/en/nevibecode/mcp/omega-memory.md) — MCP server · ★ 224
- [VelesDB Memory](https://affpapa.org/en/nevibecode/mcp/velesdb-memory.md) — MCP server · ★ 100
- [lean-memory](https://affpapa.org/en/nevibecode/mcp/lean-memory.md) — MCP server · ★ 43

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