# marm-mcp-server

This server gives AI agents shared local memory for notes, decisions, and project history. It can also index a repository so agents can find symbols and trace code paths.

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

## What it does

marm-mcp-server stores conversations, notes, and summaries in local memory that agents can search. It also builds a code graph for a repository, helping agents locate symbols and follow paths through the code. A concept graph links stored decisions, errors, and ideas to relevant code when available.

The server supports HTTP and STDIO, and agents can use the same memory across sessions. To connect it to Claude Code, run `claude mcp add marm-mcp-server -- uvx marm-mcp-server`. The memory is local, not a remote shared service; the project provides a `swarm` profile for multiple agents.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add marm-mcp-server -- uvx marm-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from marm-mcp-server <command>

### Codex

**Platform CLI**
```bash
codex mcp add marm-mcp-server -- uvx marm-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from marm-mcp-server <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "marm-mcp-server": {
            "command": "uvx",
            "args": [
                "marm-mcp-server"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from marm-mcp-server <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "marm-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "marm-mcp-server"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from marm-mcp-server <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add marm-mcp-server uvx marm-mcp-server
```
uvx runs the command named after the package; if the README names another one, use uvx --from marm-mcp-server <command>

## When to use it
- carry decisions and notes between agent sessions
- search stored conversations for past context
- locate symbols and code paths in a repository
- connect stored ideas and errors to project code

## Example prompts
- Save this project decision to shared memory.
- Find the notes about the earlier database connection error.
- Locate this symbol in the repository and trace the code paths that use it.

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