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

Installation

Make sure the project is built:

cd C:\repos\obsidian-mcp
npm install
npm run build

Add to Claude Desktop configuration:

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "node",
      "args": ["C:\\repos\\obsidian-mcp\\dist\\index.js"],
      "env": {
        "OBSIDIAN_VAULT": "C:\\Users\\YourName\\Documents\\YourVault"
      }
    }
  }
}

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

// List available vaults
list_vaults()

// Read a note
read_note(vault_path: "C:\\Users\\Name\\Vault", note_path: "Daily Notes/2024-01-17")

// Write a note
write_note(
  vault_path: "C:\\Users\\Name\\Vault",
  note_path: "New Note",
  content: "# My New Note\n\nContent here",
  mode: "overwrite"
)

// Search vault
search_vault(
  vault_path: "C:\\Users\\Name\\Vault",
  query: "project",
  options: { case_sensitive: false }
)

Vault Discovery

The server automatically discovers vaults from:

Obsidian's configuration (%APPDATA%\obsidian\obsidian.json)
Common locations:
- %USERPROFILE%\Documents\Obsidian
- %USERPROFILE%\OneDrive\Documents\Obsidian
Environment variable OBSIDIAN_VAULT

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

# Type checking
npm run typecheck

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Enables direct file system access to Obsidian vaults with auto-discovery, full-text search, and note operations. Supports reading, writing, and searching across Obsidian notes without requiring plugins or REST API.

Related MCP Servers

obsidian-mcp
StevenStavrakis
-
security
A
license
-
quality
Enables AI assistants to interact with Obsidian vaults, providing tools for reading, creating, editing and managing notes and tags.
Last updated -
276
482
TypeScript
MIT License
Obsidian Index MCP Server
tcsavage
-
security
F
license
-
quality
Provides semantic search capability over Obsidian vaults and exposes recent notes as resources to Claude through the MCP protocol.
Last updated -
6
Python
Obsidian Omnisearch MCP Server
anpigon
A
security
A
license
A
quality
Provides programmatic search functionality for Obsidian vaults through a REST API interface, allowing external applications to search through notes and retrieve absolute paths to matching documents.
Last updated -
2
18
Python
MIT License
Obsidian MCP REST Server
PublikPrinciple
-
security
A
license
-
quality
Provides a standardized interface for AI assistants to interact with Obsidian vaults through a local REST API, enabling reading, writing, searching, and managing notes.
Last updated -
52
TypeScript
MIT License

View all related MCP servers

Obsidian MCP Server