Obsidian MCP Server

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-value"
      }
    }
  }
}

claude mcp add --env OBSIDIAN_API_KEY=your-value --transport stdio obsidian-mcp-server -- npx -y obsidian-mcp-server

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-value"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "obsidian_api_key",
      "description": "OBSIDIAN_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "obsidian-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "${input:obsidian_api_key}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

• obsidian_get_note

  Read a note as raw content, full structured form, document map, or a single section

• obsidian_list_notes

  List notes and folders under a vault path, recursively, with extension and name filters

• obsidian_list_tags

  List vault tags with usage counts, most-used first

• obsidian_search_notes

  Search by text, JSONLogic, or BM25-ranked Omnisearch when that plugin is reachable

• obsidian_write_note

  Create a note, replace one section, or overwrite a whole file with overwrite: true

• obsidian_append_to_note

  Append to a note (creating it if missing) or to one heading, block, or frontmatter field

• obsidian_patch_note

  Append, prepend, or replace against one heading, block reference, or frontmatter field

• obsidian_replace_in_note

  Literal or regex search-replace inside one note, body-only by default

• obsidian_manage_frontmatter

  Get, set, or delete one frontmatter key

• obsidian_manage_tags

  Add, remove, or list a note's tags in frontmatter, inline, or both

• obsidian_delete_note

  Permanently delete a note, optionally after the user confirms (OBSIDIANDELETEELICITATION)

• obsidian_open_in_ui

  Open a file in the Obsidian app, optionally in a new pane

• obsidian_list_commands

  List command-palette commands (opt-in via OBSIDIANENABLECOMMANDS)

• obsidian_execute_command

  Run a command-palette command by ID (opt-in via OBSIDIANENABLECOMMANDS)

obsidian-mcp-server Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP. 14 Tools • 3 Resources

• ai-tools
• knowledge-base
• mcp
• model-context-protocol
• note-taking
• obsidian
• typescript
• cyanheads
• ai-agents
• bun