Install Obsidian MCP Tools

Pick your client, copy the command, done.

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

Run this once before adding it to Claude Code.

git clone https://github.com/dp-veritas/mcp-obsidian-tools.git
cd mcp-obsidian-tools
npm install
npm run build

claude mcp add obsidian-tools -- node /absolute/path/to/mcp-obsidian-tools/dist/index.js /path/to/your/vault

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

Available Tools (9)

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

obsidian_search_notesSearch for notes by filename using case-insensitive matching or regex.

query

obsidian_read_notesRead the contents of multiple notes by relative path.

pathsheadersOnly

obsidian_list_tagsScan all Markdown files and list all tags with occurrence counts.

startsWith

obsidian_notes_by_tagReturn all note paths that contain specific tags.

tagsmatch

obsidian_get_frontmatterReturn parsed YAML frontmatter as JSON for a given note path.

path

obsidian_backlinksList all notes that link to a target note path or name.

target

obsidian_search_contentFull-text search inside note contents using wildcard patterns.

queryreturnSnippets

obsidian_queryNatural-language query over the vault with optional date filtering.

querydateFilter

obsidian_count_filesCount the total number of markdown files in the vault or a specific subfolder.

subfolder

After setup, try these prompts with your AI agent:

→Find all notes in my vault that contain the tag #project-alpha.

→Search for notes mentioning 'Q4 strategy' and summarize their content.

→List all notes that link to my 'Meeting Notes' file.

→Show me the frontmatter for the note titled 'Project Roadmap'.

→Count how many markdown files are in my 'Archive' folder.

Prerequisites & system requirements

An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
Node.js 18+ with npm/npx installed

Alternative installation methods

npm install -g .

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