← Back to Obsidian MCP Server

Install Obsidian MCP Server

Pick your client, copy the command, done.

file-management
Manual setup required. The maintainer's config contains paths only you know — edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

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

Register it in Claude Code

claude mcp add -e "OBSIDIAN_VAULT_PATH=${OBSIDIAN_VAULT_PATH}" mcp-obsidian -- uv run --directory /path/to/mcp-obsidian mcp-obsidian

Replace any placeholder paths in the command with the real path on your machine.

Required:OBSIDIAN_VAULT_PATH

Environment Variables

Set these before running Obsidian MCP Server.

VariableDescriptionRequired
OBSIDIAN_VAULT_PATHThe absolute path to your Obsidian vaultYes

Available Tools (19)

Once configured, Obsidian MCP Server gives your AI agent access to:

list_filesList files and folders in the vault or a subdirectory
path
read_noteRead the contents of a note
path
write_noteCreate or overwrite a note
pathcontent
append_to_noteAppend content to the end of an existing note
pathcontent
delete_noteDelete a note or folder
path
move_noteMove or rename a note within the vault
srcdest
search_notesCase-insensitive full-text search across all .md files
query
search_by_tagFind all notes containing a specific tag
tag
get_frontmatterRead the YAML frontmatter of a note
path
update_frontmatterSet or update a frontmatter field
pathkeyvalue
get_backlinksFind all notes that link to a given note
path
get_outlinksExtract all wikilinks from a note
path
get_orphansFind notes with no incoming or outgoing links
get_daily_noteRead the daily note for a date
date_str
create_daily_noteCreate a daily note
date_str
list_tagsList all tags in the vault with usage counts
get_recent_notesList the N most recently modified notes
n
get_note_statsReturn vault statistics
list_templatesList all templates in the vault's Templates folder

Try It Out

After setup, try these prompts with your AI agent:

→Search my notes for any mentions of 'project alpha' and summarize the current status.
→List all my recent notes from the last week and identify any that are orphans.
→Create a new daily note for today and add a checklist of my top 3 priorities.
→Find all notes tagged with #research and extract their frontmatter to a summary table.
→What are the most linked notes in my vault?

Keep this setup from going cold

Save the docs, env vars, and workflow around Obsidian MCP Server in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup
← Obsidian MCP Server overview Browse file-management servers →