Skip to main content
Glama

brain-mcp

MCP server for the Brain Obsidian knowledge base. Provides tools for navigating, searching, creating, and updating notes.

Installation

uv sync

Usage

Run directly

uv run brain-mcp

Configure in Claude Code

claude mcp add brain -- uv run --directory /path/to/brain-mcp brain-mcp

Or 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

BRAIN_VAULT_PATH

Absolute path to the Obsidian vault

~/Documents/Projects/Obsidian/Brain

Tools

Tool

Description

brain_search_notes

Full-text search across notes with context snippets

brain_list_notes

List notes in a folder, filterable by frontmatter type

brain_read_note

Read a note by path or title

brain_create_note

Create a new note (defaults to Notes/ per workflow)

brain_update_note

Replace content of an existing note

brain_move_note

Move/promote a note between folders

brain_find_backlinks

Find all notes linking to a given note via wikilinks

brain_get_structure

Vault overview with folder stats and MOC - Home

brain_list_folders

List subdirectories with note counts

Prompts

Prompt

Description

vault_review

Review inbox notes for promotion readiness

kb_update

Generate a KB Update note from a work session

daily_capture

Quick-capture a fleeting note

project_status

Status overview of all active projects

find_related

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 templates

Development

# 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

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/delian-research/brain-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server