知识图谱连接工具

Obsidian Brain MCP

Bridge the gap between your AI conversations and your second brain

Stop losing insights to the void of AI chat history.
Start building a knowledge graph that grows with every conversation.

The Problem

You've been there. Hours deep in a coding session or research rabbit hole with your AI assistant. Discoveries made. Problems solved. Concepts finally clicked.

Then you close the chat.

Gone.

All those insights, explanations, and breakthroughs scattered across a poorly saved claude code sessions or chatgpt chats history. Meanwhile, your Obsidian vault sits waiting, ready to connect ideas, but completely disconnected from where your best thinking actually happens.

The Solution

Obsidian Brain MCP creates a living bridge between your AI assistant and your Obsidian vault. Your LLM doesn't just respond--it remembers, organizes, and connects.

AI Conversation  <->  Obsidian Brain MCP  <->  Your Vault

Now your assistant can:

• Capture insights directly into your vault as you discover them
• Build connections by linking new notes to existing knowledge
• Search your mind to find relevant notes you forgot you had
• Understand your graph and help you see patterns in your thinking
• Match your style by learning from how you actually write

See It In Action

Creating notes, building connections, and searching your vault--all through natural conversation.

Use Cases

## 10:30 - Standup
- Discussed [[Project Alpha]] timeline
- Decision: Push launch to Q2 #decision
- Action: Review PR #142 by EOD #todo

Features

Prerequisites

1. Obsidian 1.12.4+ (verified against 1.12.7) with the officially registered CLI:
   • In Obsidian, open Settings > General > Advanced and turn Command line interface on.
   • Accept the follow-up prompt to register it in your PATH. On Linux this copies Obsidian's bundled obsidian-cli to ~/.local/bin/obsidian (mode 755); ensure ~/.local/bin is on your PATH. On Windows it appends the install directory to the user PATH; on macOS it links into /usr/local/bin.
   • Verify the registration with obsidian version (for example, 1.12.7 (installer 1.12.7)).
   • Keep the Obsidian desktop app running while the server uses the CLI.
   • OBSIDIAN_CLI_PATH remains available when you need to point at the binary explicitly.
2. uv package manager: Install uv

Installation

Add to your MCP client configuration:

{
  "mcpServers": {
    "obsidian-brain": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"]
    }
  }
}

{
  "mcpServers": {
    "obsidian-brain": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP",
        "obsidian-brain"
      ]
    }
  }
}

codex mcp add obsidian-brain \
  -- uvx --from git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP obsidian-brain

[mcp_servers.obsidian-brain]
command = "uvx"
args = ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"]

{
  "mcpServers": {
    "obsidian-brain": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"]
    }
  }
}

{
  "servers": {
    "obsidian-brain": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"]
    }
  }
}

{
  "context_servers": {
    "obsidian-brain": {
      "command": {
        "path": "uvx",
        "args": ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"]
      }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "obsidian-brain": {
      "type": "local",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP", "obsidian-brain"],
      "enabled": true
    }
  }
}

# Run directly (for testing)
uvx --from git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP obsidian-brain

# Or install as a tool
uv tool install git+https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP
obsidian-brain

Configuration

The CLI resolves the target vault in this order:

1. The vault= argument, which the server sends when OBSIDIAN_VAULT is set.
2. The calling process's CWD, if it is inside a registered vault.
3. The most recently focused open vault window in Obsidian.
4. Otherwise the command fails with Vault not found..

If OBSIDIAN_VAULT is unset, you must have the vault open in Obsidian. The reliable option is to set it to the vault's folder name; Obsidian opens that vault's window on demand. A vault id from Obsidian's registry also works — the registry lives at ~/.config/obsidian/obsidian.json on Linux (or $XDG_CONFIG_HOME/obsidian/obsidian.json), ~/Library/Application Support/obsidian/obsidian.json on macOS, and %APPDATA%\obsidian\obsidian.json on Windows.

Application-level failures are reported as a line of STDOUT with exit code 0 (for example, Vault not found. or Error: File "X" not found.). The exception is the CLI binary failing to reach Obsidian: it exits 1 and writes The CLI is unable to find Obsidian. Please make sure Obsidian is running and try again. to STDERR.

Troubleshooting

• Command line interface is not enabled. Please turn it on in Settings > General > Advanced. — turn on Command line interface in Obsidian settings.
• Vault not found. — set OBSIDIAN_VAULT to the vault's folder name or id, or open the vault in Obsidian.
• The CLI is unable to find Obsidian. Please make sure Obsidian is running and try again. — start the Obsidian desktop app.

Onboarding writes its vault profile to Obsidian Brain/config.md — a fenced YAML block inside a Markdown note, because the Obsidian CLI can only create .md files inside the visible vault (it rewrites any other extension and cannot write dot-folders).

MCP Resources

Call refresh_vault_structure before using the cached resources and again when vault changes need to appear. It populates the cached vault structure, including the all-file index and Markdown note metadata. Non-Markdown files are indexed but marked unreadable and do not receive a vault://note/{path} URI; the note resource is Markdown-only.

MCP resource discovery and reads are what this server can guarantee. An IDE's @ picker is a host feature; no MCP server change can force resources into or customize that UI. Use the client's MCP resource browser when available, or read vault://files and then a returned note URI.

Available Tools

Vault Operations

Link Operations

Tag Operations

Search Operations

Daily Notes

Knowledge & Memory

Development

# Clone the repository
git clone https://github.com/OriginalByteMe/The-Obsidian-Brain-MCP.git
cd The-Obsidian-Brain-MCP

# Install dependencies
uv sync --dev

# Run the server from the package module
uv run python -m obsidian_brain.server

# Run tests
uv run pytest

# Lint
uv run ruff check .

The project uses mcp.server.fastmcp.FastMCP from the official MCP Python SDK v1 line and pins mcp<2. MCP v2 remains alpha, while standalone fastmcp v4 requires the mcp==2.0.0b2 prerelease.

Contributing

Contributions are welcome! Whether it's bug fixes, new features, or documentation improvements.

License

MIT -- Build something amazing with it.

Stop losing your best ideas to chat history.
Let your AI and your vault think together.