HiveMind MCP

Persistent swarm memory through Obsidian — powered by your preferred LLM providers, gated by a GitHub Sponsors subscription.

Created by HaChazal (Chaz Leland Hamm) — Metanoia Unlimited LLC. This is the memory layer of the LeviathanTalon swarm. Every agent, every conversation, every decision lives in your Obsidian vault and is recalled semantically — across any provider you already pay for.

Why this exists

AI agents forget. HiveMind MCP makes them remember — permanently, locally, in your own Obsidian vault, with semantic recall across all your preferred LLM providers (OpenAI, Anthropic, Gemini, Grok, DeepSeek, Mistral, Cohere, Cerebras, Together, OpenRouter, Braintrust) routed through the Leviathan Key Rotator so you never burn a single key dry.

What it does

• Persistent memory — reads/writes HiveMind.md and the full vault (journals, entities, decisions) through Obsidian.
• Semantic recall — embeddings + cosine similarity, not just keyword grep. Ask "what did we decide about the video pipeline?" and get the actual decision, even if the words don't match.
• Provider-agnostic — one interface, your preferred providers, key-rotated and budget-capped.
• Subscription-gated — a GitHub Sponsors subscription unlocks the paid provider tier. Free tier works fully local (Ollama) with no API costs.

Credit

This project is the work of HaChazal (Chaz Leland Hamm), Principal Operator of the LeviathanTalon swarm, founder of Metanoia Unlimited LLC. The HiveMind vault architecture, the key rotator, the swarm memory protocol, and the Obsidian integration are all his design. If you use this, star the repo and follow HaChazal — the swarm runs on community.

Install

pip install leviathan-hivemind-mcp

The distribution is leviathan-hivemind-mcp on PyPI; the command stays hivemind-mcp. Zero-config launch from anywhere (auto-downloads on first use):

uvx --from leviathan-hivemind-mcp hivemind-mcp

Or clone and run from source:

git clone https://github.com/chazam41892-gif/leviathan-hivemind-mcp
cd leviathan-hivemind-mcp
pip install -e .

Configure

Set your vault and provider keys — or drop them into the unified ~/.leviathan/HiveMind/.obsidian/HiveMind.env, which every HiveMind MCP server loads automatically (front-end ↔ back-end):

export HIVEMIND_VAULT=~/.leviathan/HiveMind          # your Obsidian vault
export HIVEMIND_OWNER=1                              # owner mode: skip subscription gate
export LEVIATHAN_KEY_OPENAI_1=sk-...                  # key rotator format
export LEVIATHAN_KEY_ANTHROPIC_1=sk-ant-...
export LEVIATHAN_BUDGET_OPENAI=10.0                  # optional budget caps

Run

hivemind-mcp

Register it in your MCP client (Claude Desktop, Cursor, OpenCode, etc.):

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

Tools

License

MIT — but the credit is HaChazal's. Star the repo. Follow the swarm.

Built by HaChazal — Metanoia Unlimited. The swarm remembers.