Skip to content
MCP server

Enigma MCP

Shared long-term memory for AI agents, stored as Markdown notes in an Obsidian vault

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Linux, Windows
Runs
Locally
Version
1.3.1
Listing updated
today

About Enigma MCP

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

The README describes Enigma as a single Rust binary that sits in front of an Obsidian vault folder and exposes it over the Model Context Protocol. Agents such as Claude Code, Codex and OpenClaw connect to the same server process type and read or write the same notes, so context from one session can be found in another.

Search combines a BM25L keyword ranking with embedding similarity from the bge-micro-v2 model, merged by reciprocal rank fusion. Entities such as people, projects and topics are extracted into ordinary notes under Claude/Graph/, so Obsidian's graph view can display them. Agents write inside a Claude/ folder by default, and writes elsewhere need an explicit confirmation flag.

The project suits people who use several AI agents with Obsidian and want them to share notes without losing control of the files. The README notes that the Windows build is new and has not yet been used day to day, and that scheduling is macOS only.

Install

Run in a terminal

claude mcp add enigma --env ENIGMA_VAULT_PATH='<ENIGMA_VAULT_PATH>' -- npx -y enigma-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "enigma": {
      "command": "npx",
      "args": [
        "-y",
        "enigma-mcp"
      ],
      "env": {
        "ENIGMA_VAULT_PATH": "<ENIGMA_VAULT_PATH>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "enigma": {
      "command": "npx",
      "args": [
        "-y",
        "enigma-mcp"
      ],
      "env": {
        "ENIGMA_VAULT_PATH": "<ENIGMA_VAULT_PATH>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "enigma": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "enigma-mcp"
      ],
      "env": {
        "ENIGMA_VAULT_PATH": "<ENIGMA_VAULT_PATH>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "enigma": {
      "command": "npx",
      "args": [
        "-y",
        "enigma-mcp"
      ],
      "env": {
        "ENIGMA_VAULT_PATH": "<ENIGMA_VAULT_PATH>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "enigma": {
      "command": "npx",
      "args": [
        "-y",
        "enigma-mcp"
      ],
      "env": {
        "ENIGMA_VAULT_PATH": "<ENIGMA_VAULT_PATH>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ENIGMA_VAULT_PATHAbsolute path to the Obsidian vaultRequired
  • ENIGMA_AGENT_NAMEName recorded on every note this agent writes

What it does

Hybrid note search
Ranks notes by keyword and by embedding similarity, then merges both lists into one result set.
Knowledge graph notes
Extracts entities and relations into Markdown notes that Obsidian's graph view can show.
Write rules in code
Agent writes stay inside the Claude/ folder unless a call explicitly confirms otherwise.
Nightly vault upkeep
A scheduled run indexes new notes, suggests filing, checks graph health and writes a report.
Typed sheets
Folders with a schema file behave as tables that agents can upsert and query.
Multi-agent sharing
Each agent runs its own server process under its own name, and every note records its author.

Good for

  • Letting Claude Code and Codex read the same project history and decisions
  • Keeping session logs, tasks and concept notes inside an existing Obsidian vault
  • Searching past research notes by meaning as well as by keyword
  • Reviewing vault health and filing suggestions with a nightly report

Pricing

Open source

Free and open source under the MIT license; no paid plan is described.

Prices change. Check rayhanson.tech before you buy.

Enigma MCP FAQ

Which operating systems does Enigma run on?

The README says it is built and tested on macOS, Linux and Windows, though daily use so far has been on macOS only.

Do I need an embedding API key?

The README says embeddings use the local bge-micro-v2 model from the Hugging Face cache, which Enigma never downloads itself.

Where is the data stored?

Notes stay as Markdown files in your vault. Caches live in a separate state folder and can be deleted and rebuilt from the notes.

What license is it under?

The README states the project is licensed under MIT.

Is Enigma MCP free?

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

How do I add Enigma MCP to Claude Code?

Run this command in your terminal: claude mcp add enigma --env ENIGMA_VAULT_PATH='<ENIGMA_VAULT_PATH>' -- npx -y enigma-mcp

What are the best alternatives to Enigma MCP?

The closest alternatives to Enigma MCP are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and NeuroStack.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers

Alternatives to Enigma MCP

  1. Codebase Memory

    MCP server

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

    Runs locally
    • Open source
    • 48.8K 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

    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. NeuroStack

    MCP server

    Local-first Markdown vault memory and semantic search for AI coding assistants

    • 21 tools
    • Remote
    • Freemium
    • 47 GitHub stars
    • Knowledge and memory
  6. note1

    MCP server

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

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