obsidian-hippocampuus-mcp

We fused Obsidian with a hippocampus. Now your vault remembers, forgets, and thinks with your AI — as a single cognitive system.

npx obsidian-hippocampuus-mcp start   # 1 command. Your AI gets a memory.

What this is

Obsidian is the best second brain ever made. 4+ million people use it. But it's passive — you write, you organize, you search. The intelligence is 100% on your side.

Hippocampuus-MCP connects your Obsidian vault directly to any AI agent (Claude, Cursor, Windsurf, Cline, any MCP client). It gives Obsidian a working memory system — not just storage, but actual memory with recall, forgetting, semantic search, and bidirectional sync.

The fusion

Your AI learns something new
  ↓  writes to hippocampus-memories/ in your vault
You open Obsidian: the AI's memory is RIGHT THERE as a markdown note
  ↓  you edit it, tag it, link it
Your AI reads your changes, adjusts its understanding
  ↓  both of you share ONE knowledge base — your vault

What makes this different

| System | Storage | You own it? | You can edit it? | Survives shutdown? | Openable in any editor? | |--------|---------|-------------|-------------------|--------------------|------------------------| | MemPalace | Proprietary DB | ❌ | ❌ | ✅ | ❌ | | supermemory | Cloud DB | ❌ | ❌ | ✅ | ❌ | | mem0 | Vector DB | ❌ | ❌ | ✅ | ❌ | | Claude Projects | Claude's servers | Partial | ❌ | ✅ | ❌ | | Hippocampuus-MCP | Your Obsidian vault | ✅ Markdown | ✅ Any editor | ✅ Your data | ✅ Yes |

Every other AI memory system treats your AI's memories as proprietary data in a black box. Only Hippocampuus-MCP puts them in your Obsidian vault — plain markdown files you own, edit, tag, graph, publish, and back up.

Capabilities

| Capability | What it does | |-----------|-------------| | Semantic memory | TF-IDF 128d embeddings. Deterministic — no API call, no cloud. Search by meaning, not keywords. | | Biological forgetting | Ebbinghaus curve R = e^(-t/s). Unused memories decay. Important ones survive. Tunable. | | Bidirectional sync | AI stores a memory → you see it as .md. You edit it → AI reads the change. | | Universal MCP bridge | Works with Claude Desktop, Cursor, Windsurf, Cline, Continue, any MCP client. | | Multi-agent memory | Multiple AIs share one vault. Claude learns. Cursor uses. Same knowledge base. | | Data sovereignty | Your vault stays on your machine. No cloud, no vendor. Plain markdown. | | Protected core | Obfuscated + integrity-guarded. The algorithm cannot be reverse-engineered or modified. |

Quick Start

# Install and run (one command)
npx obsidian-hippocampuus-mcp start

# Or install globally
npm install -g obsidian-hippocampuus-mcp
hippocampuus-mcp start

# Auto-detect your Obsidian vault
hippocampuus-mcp start --vault "/path/to/your/vault"

Then configure any MCP client:

{
  "mcpServers": {
    "hippocampuus": {
      "command": "hippocampuus-mcp",
      "args": ["start"]
    }
  }
}

MCP Tools

| Tool | What it does | |------|-------------| | remember | Store AI experience as markdown in your vault | | recall | Semantic search across all memories (TF-IDF) | | forget | Run Ebbinghaus decay to prune weak memories | | obsidian_sync | Bidirectional import/export between vault and AI | | status | Engine health, memory count, top tags |

Protected Distribution

This software is distributed as a protected binary:

• Obfuscated: Core algorithm is scrambled using control-flow flattening, dead code injection, string encoding, and identifier mangling.
• Integrity-guarded: Continuous checksum verification detects tampering and halts execution.
• License-enforced: Usage terms verified at startup.
• Binary-compiled: Available as standalone executables for Windows, Linux, and macOS.

You can USE it freely. You cannot MODIFY or REVERSE-ENGINEER it.

Binary Downloads

Pre-compiled binaries are available in the releases page:

| Platform | Download | |----------|----------| | Windows (x64) | hippocampuus-mcp-win-x64.exe | | Linux (x64) | hippocampuus-mcp-linux-x64 | | macOS (x64) | hippocampuus-mcp-macos-x64 |

Installation Options

1. Quick (npx)

npx obsidian-hippocampuus-mcp start

2. Global install

npm install -g obsidian-hippocampuus-mcp
hippocampuus-mcp start

3. Binary download

Download from releases:

• Windows: hippocampuus-mcp-win-x64.exe
• Linux: hippocampuus-mcp-linux-x64
• macOS: hippocampuus-mcp-macos-x64

4. Docker

docker run ghcr.io/josemiguel3125-sketch/hippocampuus-mcp:latest

Client Configuration

Claude Desktop

{
  "mcpServers": {
    "hippocampuus": {
      "command": "npx",
      "args": ["obsidian-hippocampuus-mcp", "start"]
    }
  }
}

Cursor

{
  "mcpServers": {
    "hippocampuus": {
      "command": "npx",
      "args": ["obsidian-hippocampuus-mcp", "start"]
    }
  }
}

Windsurf

{
  "mcpServers": {
    "hippocampuus": {
      "command": "npx",
      "args": ["obsidian-hippocampuus-mcp", "start"]
    }
  }
}

Why "Hippocampuus"?

The hippocampus is the brain region responsible for memory formation. We spell it with a double 'u' because:

1. The real name is cooler with two u's
2. It's easier to search for (no other project uses this spelling)
3. It's a nod to the Dutch/Afrikaans spelling of the word

License

Proprietary — see LICENSE. Usage, not modification.

Hippocampuus-MCP: Obsidian's memory was always there. We just gave it a hippocampus.