English Français العربية

io.github.hiveforge-sh/hivemind

Registre officiel Productivité

MCP server for Obsidian vaults - AI tools with consistent canonical context. Local-first.

Code source Documentation

Que pouvez-vous faire avec io.github.hiveforge-sh/hivemind ?

  • Timeline View — Visualize events chronologically with filtering and search
  • Graph View — Explore entity relationships with interactive visualization
  • AI Integration — MCP-compatible server for Claude, GitHub Copilot, and other AI tools
  • Pluggable Templates — Built-in templates for worldbuilding, research, people management, and more
  • Canon Workflow — Draft → Pending → Canon approval system with consistency validation
  • Obsidian Native — Works with standard markdown, YAML frontmatter, and wikilinks
  • Local-First — Your data stays on your machine

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @hiveforge/hivemind-mcp
Claude Code 
claude mcp add hivemind -e 'HIVEMIND_VAULT_PATH=<HIVEMIND_VAULT_PATH>' -e 'HIVEMIND_CONFIG_PATH=<HIVEMIND_CONFIG_PATH>' -- npx -y @hiveforge/hivemind-mcp@3.6.3
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hivemind": {
            "command": "npx",
            "args": [
                "-y",
                "@hiveforge/hivemind-mcp@3.6.3"
            ],
            "env": {
                "HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>",
                "HIVEMIND_CONFIG_PATH": "<HIVEMIND_CONFIG_PATH>"
            }
        }
    }
}

Variables d'environnement

  • HIVEMIND_VAULT_PATH obligatoire Path to your Obsidian vault directory
  • HIVEMIND_CONFIG_PATH Path to optional Hivemind config file

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Hivemind for Obsidian
  2. Why Hivemind?
  3. Features
  4. Installation
  5. Quick Start
  6. Screenshots
  7. Use Cases
  8. Documentation
  9. Community
  10. Contributing
  11. License

Hivemind for Obsidian

Your canon is the source of truth. AI stays inside the lines.

Why Hivemind?

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:

  • Timeline View — See your story's events laid out chronologically
  • Graph View — Explore relationships between characters, locations, factions, and more
  • Canon Workflow — Track which content is approved, in review, or still draft

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.

Features

  • Timeline View — Visualize events chronologically with filtering and search
  • Graph View — Explore entity relationships with interactive visualization
  • AI Integration — MCP-compatible server for Claude, GitHub Copilot, and other AI tools
  • Pluggable Templates — Built-in templates for worldbuilding, research, people management, and more
  • Canon Workflow — Draft → Pending → Canon approval system with consistency validation
  • Obsidian Native — Works with standard markdown, YAML frontmatter, and wikilinks
  • Local-First — Your data stays on your machine
Built-in Templates
TemplateUse CaseEntity Types
WorldbuildingFiction writers, game designers, RPG creatorsCharacters, Locations, Events, Factions, Lore, Assets
ResearchAcademics, knowledge workersPapers, Citations, Concepts, Notes
People ManagementManagers, team leadsPeople, Goals, Teams, 1:1 Meetings
Software ArchitectureEngineers, architectsSystems, Components, ADRs, Constraints

Define your own custom entity types via config — no code required. See CONTRIBUTING_TEMPLATES.md for details.

Installation

  1. Open Obsidian Settings
  2. Go to Community plugins → Browse
  3. Search for "Hivemind"
  4. Click Install, then Enable
Manual Installation
  1. Download the latest release from GitHub Releases
  2. Extract to your vault's .obsidian/plugins/hivemind directory
  3. Reload Obsidian and enable the plugin in Settings
AI Integration (Optional)

Want AI tools to query your vault? Set up the MCP server:

MCP Setup Guide →

The guide covers:

  • Claude Desktop configuration (Windows, macOS, Linux)
  • GitHub Copilot configuration
  • Template selection
  • Troubleshooting

Quick Start

  1. Choose a template — Open Hivemind settings in Obsidian and select a template (worldbuilding, research, etc.)
  2. Create entities — Use Obsidian's note creation as usual. Add YAML frontmatter to define entity types:
     ---
 entity_type: character
 canon_status: draft
 ---
  3. Visualize — Open the Timeline view or Graph view from the ribbon icons
  4. Connect to AI — Follow the MCP Setup Guide to let AI tools query your vault

For detailed setup instructions, see docs/SETUP_GUIDE.md.

Screenshots

Timeline View

Coming soon — chronological visualization of events

Graph View

Coming soon — interactive entity relationship visualization

Use Cases

Worldbuilding:

  • Track characters, locations, and events across your novel
  • AI remembers your character details when helping with dialogue
  • Visualize timeline of your story's key events

Research:

  • Organize papers, citations, and concepts in your field
  • AI references your actual research when answering questions
  • Explore connections between concepts in your knowledge base

People Management:

  • Track team goals, 1:1 meeting notes, and people details
  • AI recalls context from previous meetings when drafting agendas
  • Visualize team relationships and reporting structures

Software Architecture:

  • Document systems, components, and architectural decisions (ADRs)
  • AI references your ADRs when suggesting design patterns
  • Track dependencies between components visually

Documentation

Community

Contributing

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

License

MIT — Free for personal and commercial use.

Questions fréquentes

Qu'est-ce que io.github.hiveforge-sh/hivemind ?

MCP server for Obsidian vaults - AI tools with consistent canonical context. Local-first.

Comment installer io.github.hiveforge-sh/hivemind ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add hivemind -e 'HIVEMIND_VAULT_PATH=<HIVEMIND_VAULT_PATH>' -e 'HIVEMIND_CONFIG_PATH=<HIVEMIND_CONFIG_PATH>' -- npx -y @hiveforge/hivemind-mcp@3.6.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.hiveforge-sh/hivemind ?

Oui. Il attend HIVEMIND_VAULT_PATH, à renseigner dans sa configuration.

io.github.hiveforge-sh/hivemind est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.hiveforge-sh/hivemind ?

Il est publié par hiveforge-sh. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.