← Back to Obsidian MCP Server

Install Obsidian MCP Server

Pick your client, copy the command, done.

file-management
1

Add it to Claude Code

claude mcp add -e "OBSIDIAN_API_KEY=${OBSIDIAN_API_KEY}" -e "OBSIDIAN_VAULT_PATH=${OBSIDIAN_VAULT_PATH}" obsidian-mcp-8782 -- npx -y @duquesnay/obsidian-mcp-ts
Required:OBSIDIAN_API_KEYOBSIDIAN_VAULT_PATH

Environment Variables

Set these before running Obsidian MCP Server.

VariableDescriptionRequired
OBSIDIAN_API_KEYAPI key for the Local REST API pluginYes
OBSIDIAN_VAULT_PATHLocal file system path to the Obsidian vaultYes

Available Tools (6)

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

obsidian_get_all_tagsRetrieves all tags present in the Obsidian vault.
obsidian_get_recent_changesLists recently modified files in the vault.
obsidian_get_file_contentsReads the content of a specific markdown note.
path
obsidian_simple_searchPerforms a search query across the vault.
query
obsidian_list_files_in_vaultLists the structure of the entire vault.
obsidian_list_files_in_dirLists files within a specific directory in the vault.
path

Try It Out

After setup, try these prompts with your AI agent:

→List all the files in my 'Projects' folder in Obsidian.
→Search my vault for notes related to 'AI regulations' and summarize the findings.
→What are the most recently modified notes in my vault?
→Read the content of my 'Meeting Notes' file and extract the action items.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • OBSIDIAN_API_KEY — API key for the Local REST API plugin
  • OBSIDIAN_VAULT_PATH — Local file system path to the Obsidian 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 →