# Mnemosyne OS

Hooks Claude and other coding agents up to your Mnemosyne OS vaults, so the model keeps context across sessions. The memory stays on your own machine.

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

## What it does

The `@mnemosyne_os/mcp` package runs a stdio MCP server that exposes your vaults to the agent. Claude, Codex or Cursor can then read notes you filed yourself, along with whatever other agents on the machine have written.

It sits between the IDE and the Mnemosyne OS engine. Three environment variables do the wiring: `MNEMO_DEFAULT_VAULT` for the main vault, `MNEMO_VAULTS` for the rest, and `MNEMO_SDK_PORT` for the SDK endpoint. Leave them out and the server has nothing to open.

The project is open-core, with a closed part, and some listed features are marked experimental. Launch goes through `npx`, so there is no separate package install step.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `MNEMO_DEFAULT_VAULT`, `MNEMO_VAULTS`, `MNEMO_SDK_PORT` — 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 MNEMO_DEFAULT_VAULT=<MNEMO_DEFAULT_VAULT> --env MNEMO_VAULTS=<MNEMO_VAULTS> --env MNEMO_SDK_PORT=<MNEMO_SDK_PORT> --transport stdio mnemosyne-os -- npx -y @mnemosyne_os/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mnemosyne-os --env MNEMO_DEFAULT_VAULT=<MNEMO_DEFAULT_VAULT> --env MNEMO_VAULTS=<MNEMO_VAULTS> --env MNEMO_SDK_PORT=<MNEMO_SDK_PORT> -- npx -y @mnemosyne_os/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mnemosyne-os": {
            "command": "npx",
            "args": [
                "-y",
                "@mnemosyne_os/mcp"
            ],
            "env": {
                "MNEMO_DEFAULT_VAULT": "<MNEMO_DEFAULT_VAULT>",
                "MNEMO_VAULTS": "<MNEMO_VAULTS>",
                "MNEMO_SDK_PORT": "<MNEMO_SDK_PORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mnemosyne-os": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mnemosyne_os/mcp"
            ],
            "env": {
                "MNEMO_DEFAULT_VAULT": "<MNEMO_DEFAULT_VAULT>",
                "MNEMO_VAULTS": "<MNEMO_VAULTS>",
                "MNEMO_SDK_PORT": "<MNEMO_SDK_PORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MNEMO_DEFAULT_VAULT=<MNEMO_DEFAULT_VAULT> -e MNEMO_VAULTS=<MNEMO_VAULTS> -e MNEMO_SDK_PORT=<MNEMO_SDK_PORT> mnemosyne-os npx -y @mnemosyne_os/mcp
```
Replace <…> with your own values

## When to use it
- let a coding agent read your personal notes from a local vault
- carry project context from one Claude session to the next
- share a single memory store between several agents on the machine
- index a `.claude` or `.cursor` folder as a memory source
- keep working notes off hosted services

## Example prompts
- Connect my Mnemosyne OS vault and pull up what we decided about the database migration
- Show me the recent notes in the vault that other agents wrote
- Save a summary of this session to Mnemosyne OS memory

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