MCP server for Obsidian vaults - AI tools with consistent canonical context. Local-first.
Runs on your machine from its package; the steps are below.

At most: only reads or looks up information.
Odel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y @hiveforge/hivemind-mcp
MCP client config
{
"mcpServers": {
"hivemind": {
"command": "npx",
"args": [
"-y",
"@hiveforge/hivemind-mcp"
]
}
}
}
Your canon is the source of truth. AI stays inside the lines.
When building fictional worlds — whether you're writing a novel, designing a game, or running an RPG campaign — AI tools can be powerful collaborators. But they hallucinate. Ask your AI assistant about a character you created last week, and it might invent details that contradict your established canon.
Hivemind solves this by giving AI tools structured access to your Obsidian vault. Think of it as an AI Firewall: your worldbuilding notes become a truth anchor that keeps AI grounded in facts you control. Ask about a character, and the AI reads your actual notes — not a hallucinated version. Query a timeline, and it references your established events — not invented dates.
Beyond AI integration, Hivemind provides powerful visualization tools:
Hivemind is built for worldbuilders, but the same principles apply to research vaults, people management, software architecture — anywhere you need AI to respect your established knowledge.
| Template | Use Case | Entity Types |
|---|---|---|
| Worldbuilding | Fiction writers, game designers, RPG creators | Characters, Locations, Events, Factions, Lore, Assets |
| Research | Academics, knowledge workers | Papers, Citations, Concepts, Notes |
| People Management | Managers, team leads | People, Goals, Teams, 1:1 Meetings |
| Software Architecture | Engineers, architects | Systems, Components, ADRs, Constraints |
Define your own custom entity types via config — no code required. See CONTRIBUTING_TEMPLATES.md for details.
.obsidian/plugins/hivemind directoryWant AI tools to query your vault? Set up the MCP server:
The guide covers:
Choose a template — Open Hivemind settings in Obsidian and select a template (worldbuilding, research, etc.)
Create entities — Use Obsidian's note creation as usual. Add YAML frontmatter to define entity types:
---
entity_type: character
canon_status: draft
---
Visualize — Open the Timeline view or Graph view from the ribbon icons
Connect to AI — Follow the MCP Setup Guide to let AI tools query your vault
For detailed setup instructions, see docs/SETUP_GUIDE.md.
Coming soon — chronological visualization of events

Coming soon — interactive entity relationship visualization

Worldbuilding:
Research:
People Management:
Software Architecture:
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
Important: This project uses Conventional Commits. Commit messages must follow the format:
<type>: <description>
[optional body]
Common types: feat, fix, docs, style, refactor, test, chore
MIT — Free for personal and commercial use.