# rutter

> rutter is an open-source MCP server for knowledge and memory. Recall past decisions and cited notes from a local markdown folder across AI agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux
- **Website:** https://ruttermemory.com
- **Repository:** https://github.com/shinytoyrobots/rutter
- **MCP Registry name:** io.github.shinytoyrobots/rutter
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

Rutter is a memory layer made of plain files. When a session reaches a decision, the client leaves one line about it, and a hook stores that line unedited in a dated, append-only file in a `_librarian/` folder beside your notes. Each record lists the notes the session cited, with their paths and a content hash taken at capture.

The MCP server then lets any client search and recall those records. A note that was renamed without edits is followed by its hash, and a reference that cannot be placed is shown as unresolved rather than dropped. A note edited in place is not flagged yet, and a listed note does not prove the model opened it. There is no model inside it; the reasoning stays in your client.

Capture hooks exist for Claude Code, Codex, Grok, GitHub Copilot CLI, Antigravity CLI and Muse Code, and any other MCP client can recall with one config entry but cannot capture. Memory is shared between one person's agents, not between people. The README calls it a personal tool published as a reference implementation, with no support commitment.

## Features

- **Plain markdown records:** Dated, append-only files in a folder you own, readable in a terminal and committable to git.
- **Cited notes with hashes:** Each record lists the notes cited and a content hash from capture.
- **Six capture hooks:** Claude Code, Codex, Grok, Copilot CLI, Antigravity and Muse Code can write records.
- **Recall from any MCP client:** Any client can search and recall with one config entry.
- **Unresolved references:** References it cannot place are shown, not dropped.
- **Works with Obsidian:** Point it at a folder of markdown notes such as an Obsidian vault.

## Good for

- Ask what you concluded last week, in a different AI tool
- Keep one decision log across Claude Code and Codex
- Trace which notes informed a past decision
- Build a git-tracked history of choices made in AI sessions

## Install

### Claude Code (Terminal)

```sh
claude mcp add rutter --env LIBRARIAN_VAULT_PATH='<LIBRARIAN_VAULT_PATH>' -- npx -y rutter-memory
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rutter": {
      "command": "npx",
      "args": [
        "-y",
        "rutter-memory"
      ],
      "env": {
        "LIBRARIAN_VAULT_PATH": "<LIBRARIAN_VAULT_PATH>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "rutter": {
      "command": "npx",
      "args": [
        "-y",
        "rutter-memory"
      ],
      "env": {
        "LIBRARIAN_VAULT_PATH": "<LIBRARIAN_VAULT_PATH>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "rutter": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "rutter-memory"
      ],
      "env": {
        "LIBRARIAN_VAULT_PATH": "<LIBRARIAN_VAULT_PATH>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "rutter": {
      "command": "npx",
      "args": [
        "-y",
        "rutter-memory"
      ],
      "env": {
        "LIBRARIAN_VAULT_PATH": "<LIBRARIAN_VAULT_PATH>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "rutter": {
      "command": "npx",
      "args": [
        "-y",
        "rutter-memory"
      ],
      "env": {
        "LIBRARIAN_VAULT_PATH": "<LIBRARIAN_VAULT_PATH>"
      }
    }
  }
}
```

## FAQ

### Where are records stored?

As markdown in a `_librarian/` folder beside your notes, set by LIBRARIAN_VAULT_PATH.

### What is the npm package called?

rutter-memory. The name rutter on npm belongs to an unrelated library.

### Can several people share it?

No. Shared means one person's agents sharing one memory, not sharing between people.

### Is it a supported product?

The README says it is a personal tool published as a reference implementation, with no support commitment.

### Is rutter free?

Yes. rutter is open source, so you can use and self-host it for free.

### How do I add rutter to Claude Code?

Run this command in your terminal: claude mcp add rutter --env LIBRARIAN_VAULT_PATH='<LIBRARIAN_VAULT_PATH>' -- npx -y rutter-memory

### What are the best alternatives to rutter?

The closest alternatives to rutter are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/rutter
