obsidian-mcp-server MCP Server

Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.

Local serverstdioApache-2.0

What is the obsidian-mcp-server MCP Server?

obsidian-mcp-server source profile. From the maintainer documentation: “Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.”

Local setup

The project provides a local client configuration using bunx. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL, OBSIDIAN_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

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_get_noteRead a note as raw content, full structured form, document map, or a single section
obsidian_list_notesList notes and folders under a vault path, recursively, with extension and name filters
obsidian_list_tagsList vault tags with usage counts, most-used first
obsidian_search_notesSearch by text, JSONLogic, or BM25-ranked Omnisearch when that plugin is reachable
obsidian_write_noteCreate a note, replace one section, or overwrite a whole file with overwrite: true
obsidian_append_to_noteAppend to a note (creating it if missing) or to one heading, block, or frontmatter field
obsidian_patch_noteAppend, prepend, or replace against one heading, block reference, or frontmatter field
obsidian_replace_in_noteLiteral or regex search-replace inside one note, body-only by default
obsidian_manage_frontmatterGet, set, or delete one frontmatter key
obsidian_manage_tagsAdd, remove, or list a note's tags in frontmatter, inline, or both
obsidian_delete_notePermanently delete a note, optionally after the user confirms (OBSIDIAN_DELETE_ELICITATION)
obsidian_open_in_uiOpen a file in the Obsidian app, optionally in a new pane
obsidian_list_commandsList command-palette commands (opt-in via OBSIDIAN_ENABLE_COMMANDS)
obsidian_execute_commandRun a command-palette command by ID (opt-in via OBSIDIAN_ENABLE_COMMANDS)

How to install the obsidian-mcp-server MCP Server

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": [
        "obsidian-mcp-server@latest"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "OBSIDIAN_API_KEY": "YOUR_OBSIDIAN_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
MCP_TRANSPORT_TYPEDeclared in the maintainer’s client configuration.Check documentation
MCP_LOG_LEVELDeclared in the maintainer’s client configuration.Check documentation
OBSIDIAN_API_KEYDeclared in the maintainer’s client configuration.Yes