Skip to content
MCP server

rutter

Recall past decisions and cited notes from a local markdown folder across AI agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
1.0.1
Listing updated
3 days ago

About rutter

rutter is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • LIBRARIAN_VAULT_PATHFolder of markdown notes (an Obsidian vault works)Required
  • LIBRARIAN_USER_LABELName the server uses for whose work this is; defaults to 'the user'

What it does

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

Pricing

Open source

Free; runs locally.

Prices change. Check ruttermemory.com before you buy.

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

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity