Obsidian MCP Server

Direct file system access to Obsidian vaults through Model Context Protocol (MCP).

Features

• Direct vault access - No plugins or REST API required

• Auto-discovery - Finds vaults from Obsidian config and common locations

• Full-text search - Search across all notes with regex support

• Note operations - Read, write, append, prepend to notes

• Vault management - List vaults, get statistics, browse files

• Windows optimized - Handles Windows paths correctly

Related MCP server: Obsidian Index MCP Server

Installation

1. Make sure the project is built:

2. Add to Claude Desktop configuration:

Edit %APPDATA%\Claude\claude_desktop_config.json:

3. Restart Claude Desktop

Available Tools

Vault Management

• list_vaults - Discover available Obsidian vaults

• get_vault_info - Get statistics about a vault

Note Operations

• read_note - Read a note with frontmatter and metadata

• write_note - Create or update a note (overwrite/append/prepend)

• list_notes - List all notes in vault or folder

Search

• search_vault - Full-text search with regex and case-sensitive options

Usage Examples

Vault Discovery

The server automatically discovers vaults from:

1. Obsidian's configuration (%APPDATA%\obsidian\obsidian.json)

2. Common locations:

   • %USERPROFILE%\Documents\Obsidian

   • %USERPROFILE%\OneDrive\Documents\Obsidian

3. Environment variable OBSIDIAN_VAULT

Development

Troubleshooting

• No vaults found: Make sure you have at least one Obsidian vault with .obsidian folder or .md files

• Permission errors: Run Claude Desktop as the same user who owns the vault files

• Path not found: Use full absolute paths for vault_path

Future Features

• Graph navigation (trace links N levels deep)

• Template execution

• Smart search with fuzzy matching

• Active file tracking

• Partial file updates (patch operations)

• Frontmatter management