Obsidian MCP Server

MCP server for Obsidian vaults that survives iCloud — reads, searches and writes notes without hanging on evicted files

Local serverstdio

What is the Obsidian MCP Server?

MCP server for Obsidian vaults that survives iCloud — reads, searches and writes notes without hanging on evicted files

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
obsidian_list_notesList Markdown notes, optionally under a subdirectory
obsidian_search_notesFull-text search with path, line number and excerpt
obsidian_read_noteRead one note
obsidian_create_noteCreate a note; refuses to overwrite
obsidian_update_noteAtomic overwrite of an existing note
obsidian_vault_healthMaterialized vs evicted counts, bytes pending, largest evicted notes — stat-only, never blocks
obsidian_warm_notesOpt-in background downloads for evicted notes, bounded per call

How to install the Obsidian MCP Server

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "obsidian-icloud-mcp"],
      "env": {
        "OBSIDIAN_VAULTS": "{\"Personal\":\"/Users/you/Documents/Notes\"}"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
OBSIDIAN_VAULTSConfiguration value read at startup.Optional

Example prompts to try

  • “Use Obsidian to obsidian list notes.”
  • “Use Obsidian to obsidian search notes.”
  • “Use Obsidian to obsidian read note.”

Frequently asked questions

MCP server for Obsidian vaults that survives iCloud — reads, searches and writes notes without hanging on evicted files Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.