brain-mcp is an MCP server for managing an Obsidian knowledge base vault, providing tools to navigate, search, create, and organize notes.
Search & Discovery
brain_search_notes: Full-text search across the vault with context snippets, optionally scoped to a folderbrain_list_notes: Browse notes in a folder, filterable by frontmatter type (moc, project, area, resource, archive)brain_find_backlinks: Discover all notes linking to a given note via[[wikilinks]]brain_get_structure: High-level vault overview including folder stats and MOC-Home contentbrain_list_folders: List subdirectories with note counts to explore the vault hierarchy
Note Management
brain_read_note: Retrieve full markdown content and metadata (frontmatter, wikilinks) by path or titlebrain_create_note: Create a new note with title and content, defaulting to theNotes/inbox folderbrain_update_note: Replace a note's full content with automatic frontmatter date stampingbrain_move_note: Move/promote notes between folders (e.g., inbox → Projects or APIs)
Workflow Prompts
Includes prompt-driven workflows: vault_review (inbox triage), kb_update (knowledge base updates), daily_capture (fleeting notes), project_status (project overviews), and find_related (content mapping).
Provides tools for navigating, searching, and managing notes within an Obsidian vault, including capabilities for full-text search, note creation and updates, backlink discovery, and folder structure management.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@brain-mcpsearch my vault for notes about artificial intelligence"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
brain-mcp
MCP server for the Brain Obsidian knowledge base. Provides tools for navigating, searching, creating, and updating notes.
Installation
uv syncUsage
Run directly
uv run brain-mcpConfigure in Claude Code
claude mcp add brain -- uv run --directory /path/to/brain-mcp brain-mcpOr add to ~/.claude.json:
{
"mcpServers": {
"brain": {
"command": "uv",
"args": ["run", "--directory", "/path/to/brain-mcp", "brain-mcp"],
"env": {
"BRAIN_VAULT_PATH": "/path/to/your/obsidian/vault"
}
}
}
}Configure in Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"brain": {
"command": "uv",
"args": ["run", "--directory", "/path/to/brain-mcp", "brain-mcp"],
"env": {
"BRAIN_VAULT_PATH": "/path/to/your/obsidian/vault"
}
}
}
}Environment Variables
Variable | Description | Default |
| Absolute path to the Obsidian vault |
|
Tools
Tool | Description |
| Full-text search across notes with context snippets |
| List notes in a folder, filterable by frontmatter type |
| Read a note by path or title |
| Create a new note (defaults to Notes/ per workflow) |
| Replace content of an existing note |
| Move/promote a note between folders |
| Find all notes linking to a given note via wikilinks |
| Vault overview with folder stats and MOC - Home |
| List subdirectories with note counts |
Prompts
Prompt | Description |
| Review inbox notes for promotion readiness |
| Generate a KB Update note from a work session |
| Quick-capture a fleeting note |
| Status overview of all active projects |
| Map all Brain content related to a topic |
Vault Structure
The server expects an Obsidian vault with these canonical folders:
Brain/
├── Notes/ ← Inbox: fleeting notes, KB Updates
├── APIs/ ← External API references
├── Infrastructure/ ← Servers, databases, networking
├── Personal/ ← Personal notes
├── Projects/ ← Active project trackers
├── Repositories/ ← Code repository references
├── Tooling/ ← AI tool configuration
├── Workflows/ ← Standards and processes
└── _Templates/ ← Note templatesDevelopment
# Install with dev dependencies
uv sync --group dev
# Run tests
uv run pytest
# Lint & format
uv run ruff check .
uv run ruff format .License
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.