What is Hivemind MCP and how does it work with Obsidian?

Hivemind is an MCP server that connects your local Obsidian vault to AI models, letting you query notes and retrieve consistent canonical context. It runs locally on your machine and reads from your vault directory via the HIVEMIND_VAULT_PATH environment variable.

How do I set up Hivemind MCP?

Install via `npx @hiveforge/hivemind-mcp@3.6.3`, then set the required HIVEMIND_VAULT_PATH environment variable to point to your Obsidian vault directory. Optionally, configure HIVEMIND_CONFIG_PATH to use a custom config file.

Is Hivemind local-first and does it send data to external servers?

Yes, Hivemind is designed as local-first. It reads directly from your vault on disk and does not require cloud services, keeping your knowledge base private and under your control.

Can I use a custom configuration file with Hivemind?

Yes, you can set the HIVEMIND_CONFIG_PATH environment variable to point to an optional Hivemind config file. If not set, the server will use default behavior.

What happens if HIVEMIND_VAULT_PATH is not set?

HIVEMIND_VAULT_PATH is required for Hivemind to function. The server will not start without it, so you must provide the path to your Obsidian vault directory before connecting the MCP server.

MCP ServerSTDIOOfficialv3.6.3

Hiveforge Sh Hivemind MCP Server

Query and manage Obsidian vaults with AI-powered context retrieval. Built for developers who need local-first, canonical knowledge management integrated into their LLM workflows.

io.github.hiveforge-sh/hivemind

Try MCP with AI models View source

Hosted URL

Local install

Transport

STDIO

Auth

1 required env var

What the Hiveforge Sh Hivemind MCP server does

How models use it and what it is built for.

Query and manage Obsidian vaults with AI-powered context retrieval. Built for developers who need local-first, canonical knowledge management integrated into their LLM workflows.

Connect to Hiveforge Sh Hivemind

Local install — runs as a subprocess.

npx @hiveforge/hivemind-mcp@3.6.3

Environment variables

Configuration this server reads at startup.

HIVEMIND_VAULT_PATHRequired
Path to your Obsidian vault directory
HIVEMIND_CONFIG_PATH
Path to optional Hivemind config file

Resources

Where to find authoritative docs and source for Hiveforge Sh Hivemind.

Source repository

Example prompts for Hiveforge Sh Hivemind

Paste any of these into Agent Studio after connecting Hiveforge Sh Hivemind.

Search my vault for notes about authentication patterns and summarize the key concepts
What does my vault say about the database schema for user accounts?
List all notes tagged with 'architecture' and show their relationships
Explain how the HIVEMIND_VAULT_PATH configuration works and what it expects

Hiveforge Sh Hivemind MCP server — FAQ

Common questions about connecting and running Hiveforge Sh Hivemind.

What is Hivemind MCP and how does it work with Obsidian?
Hivemind is an MCP server that connects your local Obsidian vault to AI models, letting you query notes and retrieve consistent canonical context. It runs locally on your machine and reads from your vault directory via the HIVEMIND_VAULT_PATH environment variable.
How do I set up Hivemind MCP?
Install via `npx @hiveforge/hivemind-mcp@3.6.3`, then set the required HIVEMIND_VAULT_PATH environment variable to point to your Obsidian vault directory. Optionally, configure HIVEMIND_CONFIG_PATH to use a custom config file.
Is Hivemind local-first and does it send data to external servers?
Yes, Hivemind is designed as local-first. It reads directly from your vault on disk and does not require cloud services, keeping your knowledge base private and under your control.
Can I use a custom configuration file with Hivemind?
Yes, you can set the HIVEMIND_CONFIG_PATH environment variable to point to an optional Hivemind config file. If not set, the server will use default behavior.
What happens if HIVEMIND_VAULT_PATH is not set?
HIVEMIND_VAULT_PATH is required for Hivemind to function. The server will not start without it, so you must provide the path to your Obsidian vault directory before connecting the MCP server.

Skip the local setup — run MCP in your browser

MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 60+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.

Open Agent Studio