# hivemind

Connects local Obsidian vaults to coding assistants via MCP. Keeps AI responses grounded in verified notes and project lore without hallucinations.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: hiveforge-sh
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hiveforge-sh/hivemind
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/hivemind

## What it does

The server provides tools like Claude Code, Codex, and Cursor with structured access to markdown files in an Obsidian vault. It parses YAML frontmatter and wikilinks to retrieve entities such as ADR documents, research notes, or fiction world lore.

Content passes through a canon workflow with draft, pending, and approved statuses. Without setting the `HIVEMIND_VAULT_PATH` environment variable, the process cannot locate the vault and fails to start. Processing stays local on your machine.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `HIVEMIND_VAULT_PATH`, `HIVEMIND_CONFIG_PATH` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env HIVEMIND_VAULT_PATH=<HIVEMIND_VAULT_PATH> --env HIVEMIND_CONFIG_PATH=<HIVEMIND_CONFIG_PATH> --transport stdio hivemind -- npx -y @hiveforge/hivemind-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add hivemind --env HIVEMIND_VAULT_PATH=<HIVEMIND_VAULT_PATH> --env HIVEMIND_CONFIG_PATH=<HIVEMIND_CONFIG_PATH> -- npx -y @hiveforge/hivemind-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hivemind": {
            "command": "npx",
            "args": [
                "-y",
                "@hiveforge/hivemind-mcp"
            ],
            "env": {
                "HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>",
                "HIVEMIND_CONFIG_PATH": "<HIVEMIND_CONFIG_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hivemind": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@hiveforge/hivemind-mcp"
            ],
            "env": {
                "HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>",
                "HIVEMIND_CONFIG_PATH": "<HIVEMIND_CONFIG_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e HIVEMIND_VAULT_PATH=<HIVEMIND_VAULT_PATH> -e HIVEMIND_CONFIG_PATH=<HIVEMIND_CONFIG_PATH> hivemind npx -y @hiveforge/hivemind-mcp
```
Replace <…> with your own values

## When to use it
- ground AI responses in canonical Obsidian markdown notes
- feed architectural decision records directly to coding tools
- track consistency across draft and approved entity states
- retrieve lore and character relations during text generation

## Example prompts
- Check the Obsidian vault for approved architectural constraints on our API service.
- List all canonical characters belonging to the northern faction according to my notes.
- Review the draft ADR notes and summarize the pending database decisions.

## Similar
- [worldbuilding](https://affpapa.org/en/nevibecode/skills/worldbuilding.md) — skill · 912 installs
- [shared-world](https://affpapa.org/en/nevibecode/skills/shared-world.md) — skill · 453 installs
- [llm-wiki](https://affpapa.org/en/nevibecode/skills/ar9av-llm-wiki.md) — skill · 4100 installs
- [wiki-update](https://affpapa.org/en/nevibecode/skills/wiki-update.md) — skill · 3400 installs
- [moc-agent](https://affpapa.org/en/nevibecode/agents/moc-agent.md) — subagent · 666 installs
- [obsidian-markdown](https://affpapa.org/en/nevibecode/skills/agricidaniel-obsidian-markdown.md) — skill · 545 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md