obsidian-mcp

MCP server that connects Claude Code (or any MCP client) to your Obsidian vault. Search, read, create, and navigate your vault as a knowledge graph.

Requires Obsidian with CLI enabled (Settings > General > CLI).

Install

# With Claude Code
claude mcp add obsidian -- npx obsidian-mcp --vault "My Vault"

# Or in ~/.claude.json
{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["obsidian-mcp", "--vault", "My Vault"],
      "env": {}
    }
  }
}

Find your vault name with obsidian vaults in Terminal.

Tools (26)

Search (3)

| Tool | Description | |------|-------------| | obsidian_search | Full-text search with line context | | obsidian_tags | List tags with occurrence counts | | obsidian_properties | List YAML frontmatter properties |

Files (10)

| Tool | Description | |------|-------------| | obsidian_read | Read file by name or path | | obsidian_file_info | File metadata (size, created, modified) | | obsidian_outline | Heading structure of a file | | obsidian_create | Create a new file (with optional template) | | obsidian_append | Append content to a file | | obsidian_move | Move/rename (auto-updates all wikilinks) | | obsidian_property_read | Read a frontmatter property | | obsidian_property_set | Set a frontmatter property | | obsidian_recents | Recently opened files | | obsidian_vault_info | Vault stats (files, folders, size) |

Graph (5)

| Tool | Description | |------|-------------| | obsidian_backlinks | Files linking TO a file | | obsidian_links | Outgoing links FROM a file | | obsidian_orphans | Files with no incoming links | | obsidian_unresolved | Broken wikilinks | | obsidian_tasks | Checkbox tasks across the vault |

Daily Notes (4)

| Tool | Description | |------|-------------| | obsidian_daily_read | Read today's daily note | | obsidian_daily_append | Append to daily note | | obsidian_daily_prepend | Prepend to daily note | | obsidian_daily_path | Get daily note path |

Bases (4)

| Tool | Description | |------|-------------| | obsidian_bases_list | List Base files in vault | | obsidian_base_views | List views in a Base | | obsidian_base_query | Query a Base (structured results) | | obsidian_base_create_item | Create item in a Base |

Requirements

• Obsidian must be running (CLI communicates with the app)
• CLI enabled in Obsidian Settings > General
• Node.js >= 18

Configuration

The vault is specified via --vault flag or OBSIDIAN_VAULT_NAME environment variable.

# Flag
npx obsidian-mcp --vault="My Vault"

# Environment variable
OBSIDIAN_VAULT_NAME="My Vault" npx obsidian-mcp

Known Issues

• search:context with format=json returns empty for multi-word queries (Obsidian CLI bug in 1.12.x). The server automatically falls back to text parsing.
• Obsidian CLI prints loader messages to stdout. The server strips these automatically.

License

MIT