Enigma MCP
Shared long-term memory for AI agents, stored as Markdown notes in an Obsidian vault
- 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-mcpAdd 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 vaultRequiredENIGMA_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.
Alternatives to Enigma MCP

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.8K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP 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

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

NeuroStack
MCP serverLocal-first Markdown vault memory and semantic search for AI coding assistants
- 21 tools
- Remote
- Freemium
- 47 GitHub stars
- Knowledge and memory

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity