An MCP (Model Context Protocol) server for Obsidian worldbuilding vaults that provides AI tools with consistent, canonical context from your fictional worlds.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add hivemind --env HIVEMIND_VAULT_PATH='<HIVEMIND_VAULT_PATH>' -- npx -y @hiveforge/hivemind-mcp~/.codex/config.toml
[mcp_servers.hivemind]
command = "npx"
args = ["-y", "@hiveforge/hivemind-mcp"]
env = { HIVEMIND_VAULT_PATH = "<HIVEMIND_VAULT_PATH>" }
# codex mcp add hivemind --env HIVEMIND_VAULT_PATH='<HIVEMIND_VAULT_PATH>' -- npx -y @hiveforge/hivemind-mcp~/.cursor/mcp.json
{
"mcpServers": {
"hivemind": {
"command": "npx",
"args": [
"-y",
"@hiveforge/hivemind-mcp"
],
"env": {
"HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"hivemind": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hiveforge/hivemind-mcp"
],
"env": {
"HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"hivemind": {
"command": "npx",
"args": [
"-y",
"@hiveforge/hivemind-mcp"
],
"env": {
"HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"hivemind": {
"command": "npx",
"args": [
"-y",
"@hiveforge/hivemind-mcp"
],
"env": {
"HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"hivemind": {
"command": "npx",
"args": [
"-y",
"@hiveforge/hivemind-mcp"
],
"env": {
"HIVEMIND_VAULT_PATH": "<HIVEMIND_VAULT_PATH>"
}
}
}
}Environment variables
HIVEMIND_VAULT_PATH
Replace the placeholders with your own credentials and keep them out of version control.