Obsidian

An MCP server that exposes your Obsidian vault to AI assistants via the Model Context Protocol.

Requirements

• Python 3.12+
• uv

Installation

git clone https://github.com/johnkang/mcp-obsidian
cd mcp-obsidian
uv sync

Usage

Set the OBSIDIAN_VAULT_PATH environment variable to the absolute path of your vault, then run the server:

OBSIDIAN_VAULT_PATH=/path/to/your/vault uv run mcp-obsidian

Claude Desktop Integration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-obsidian", "mcp-obsidian"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
      }
    }
  }
}

The config file is located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Tools

File Operations

Tool	Description
list_files(path="")	List files and folders in the vault or a subdirectory
read_note(path)	Read the contents of a note
write_note(path, content)	Create or overwrite a note (parent dirs created automatically)
append_to_note(path, content)	Append content to the end of an existing note
delete_note(path)	Delete a note or folder
move_note(src, dest)	Move or rename a note within the vault

Search

Tool	Description
search_notes(query)	Case-insensitive full-text search across all .md files
search_by_tag(tag)	Find all notes containing a specific tag

Frontmatter

Tool	Description
get_frontmatter(path)	Read the YAML frontmatter of a note
update_frontmatter(path, key, value)	Set or update a frontmatter field (creates it if absent)

Links & Graph

Tool	Description
get_backlinks(path)	Find all notes that link to a given note via [[wikilinks]]
get_outlinks(path)	Extract all [[wikilinks]] from a note
get_orphans()	Find notes with no incoming or outgoing links

Daily Notes

Tool	Description
get_daily_note(date_str="")	Read the daily note for a date (defaults to today, format: YYYY-MM-DD)
create_daily_note(date_str="")	Create a daily note, using a daily template from Templates/ if available

Utility

Tool	Description
list_tags()	List all tags in the vault with usage counts
get_recent_notes(n=10)	List the N most recently modified notes
get_note_stats()	Return vault statistics (note count, word count, tags, links)
list_templates()	List all templates in the vault's Templates/ folder

Security

All file paths are validated to prevent path traversal attacks — no operation can escape the configured vault directory.