Skip to content
MCP server

Minnimemory

Splits Claude Code and Codex memory files into always-loaded and on-demand parts

Runs locallyStatus and history
Pricing
Free
Platforms
CLI, macOS, Windows
Runs
Locally
GitHub stars
0
Last commit
8 days ago
Language
JavaScript

About Minnimemory

Minnimemory is a free MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

Memory files such as CLAUDE.md, AGENTS.md and a memory folder are re-read on every turn, and most of their content has nothing to do with the task at hand. This server audits those files and compiles them into a small always-on section plus separate files that load only when a prompt needs them.

The workflow is four commands. init maps what gets loaded and previews the split without changing anything; apply makes the change after backing up the originals; undo restores them byte for byte; doctor re-checks later for drift. In Claude Code, apply and undo return a command that runs through your approval prompt. The developer reports one sample map going from 12,511 to 6,699 tokens per turn and, in its best Claude Code run, a session cost of $0.83 falling to $0.57; the median of 13 runs was 15.9% cheaper. These are the vendor's own figures from its own memory folder.

It runs entirely on your computer with no model inside it, no API key and no network traffic. It supports Claude Code and Codex only. The plugin also adds hooks that inject the one matching memory section before each prompt and warn when memory drifted. The pricing is free during early access and the rule set is proprietary.

Install

Run in a terminal

claude mcp add minnimemory -- npx -y minnimemory

Add to claude_desktop_config.json

{
  "mcpServers": {
    "minnimemory": {
      "command": "npx",
      "args": [
        "-y",
        "minnimemory"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "minnimemory": {
      "command": "npx",
      "args": [
        "-y",
        "minnimemory"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "minnimemory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "minnimemory"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "minnimemory": {
      "command": "npx",
      "args": [
        "-y",
        "minnimemory"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "minnimemory": {
      "command": "npx",
      "args": [
        "-y",
        "minnimemory"
      ]
    }
  }
}

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

init
Maps the memory files your agent loads and previews the split.
doctor
Re-checks memory for drift and shows a re-apply plan.
apply
Splits memory into always-on and on-demand parts, returning a command for approval.
undo
Restores the original files.

What it does

Memory map
Lists which files load every turn and which content could move to on-demand.
Lossless apply
Backs up originals first and keeps every line.
Undo
Restores the original files byte for byte.
Drift check
doctor shows what changed since the last apply and a re-apply plan.
Prompt hook
Adds only the memory section matching the prompt, marked as data.
Local only
Runs with no model, no API key and no network traffic.

Good for

  • Cut the token cost of a bloated CLAUDE.md
  • Trim an oversized AGENTS.md for Codex
  • Audit which memory files an agent loads on each turn
  • Keep memory tidy as notes grow week by week

Pricing

Free

Free during early access

Prices change. Check minniai.com before you buy.

Minnimemory FAQ

Does it delete anything?

No. The site says every line is kept and the originals are backed up before apply.

Which agents work with it?

Claude Code and Codex. Other tools are not supported yet.

What does it cost?

Free during early access, per the website. The rule set is proprietary.

Does it send data off my machine?

No. The tools send nothing over the internet.

What does it require?

Node.js 18.3 or later.

Is Minnimemory free?

Yes. Minnimemory is free to use.

How do I add Minnimemory to Claude Code?

Run this command in your terminal: claude mcp add minnimemory -- npx -y minnimemory

What are the best alternatives to Minnimemory?

The closest alternatives to Minnimemory are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Minnimemory

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. 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
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. 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
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools