# Mneme

A local layer between your agent and your code: it screens actions, keeps secrets out of the model, carries memory across sessions and meters saved tokens.

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

## What it does

Mneme runs as an MCP server on top of your git history and source tree. The agent asks it for context and gets back only what passed screening — secrets and destructive commands are stopped at the boundary, not after the model has already read them. Memory is signed and travels between assistants, so what one agent learned the next one inherits.

There are over 900 tools inside, and you never have to browse them: the agent searches by task description in English or Thai. Output gets checked too — a trust certificate is refused when a known fault is present. Public claims in the project are bound to probes, and the build fails if one drifts.

Worth setting up if you let an agent loose in a real repository and want a record of what it did. It launches through `npx -y mneme-ai`, so Node.js and npm have to be on your `PATH`; without them the server will not start. MIT licensed, with parts built to work without network access.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mneme-ai -- npx -y mneme-ai
```

### Codex

**Platform CLI**
```bash
codex mcp add mneme -- npx -y mneme-ai
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mneme npx -y mneme-ai
```

## When to use it
- keep repository secrets out of the model context
- carry agent memory across sessions and between assistants
- catch a fabricated answer before it reaches the code
- grade an agent's safety surface and find privilege-escalation paths
- cut token spend on reading large files

## Example prompts
- Ask Mneme for a tool that maps file structure and show me the skeleton of `src/server.ts`
- Have Mneme check whether secrets leaked into this session's context
- Save to Mneme memory that the project builds with `pnpm build`

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