Skip to content

obsidian-mcp-server

Apache-2.0★ 706updated 11 Nov 2026

Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.

What can you do with obsidian-mcp-server?

  • Typed client for the Obsidian Local REST API plugin; section writes speak markdown-patch 2.0 to plugin v5.0 and later and 1.x to v4.x, chosen from the reported plugin version
  • Regex inputs are capped (nameRegex at 256 chars, useRegex at 1024) and rejected with regexunsafe` when they nest quantifiers
  • Recovery-guided errors: every declared failure carries a reason, a JSON-RPC code, and a recovery.hint written for that case
  • Size deltas: every mutating tool returns previousSizeInBytes / currentSizeInBytes, so a caller can spot an accidental clobber without a follow-up read
  • Ambiguity surfaced as data: shared heading names return candidates, and tag operations report applied vs. skipped
  • Discriminated output contracts: format on obsidiangetnote, mode on obsidiansearchnotes, operation on obsidianmanagefrontmatter and obsidianmanagetags

Features as listed in the project's README, checked 16 Nov 2026.

About obsidian-mcp-server

Read, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP. Your Obsidian vault, through the Local REST API plugin. Read, search, and write notes, edit a single heading, block, or frontmatter field in place, and manage tags, with folder-scoped read/write permissions built in.

Opening text of the project's README, checked 16 Nov 2026.

Install

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

Config as documented in its source, checked 16 Nov 2026. Placeholders such as API keys are the project's own: replace them with your values.

Requirements listed

  • The Obsidian Local REST API plugin, v4.0.0 or later, enabled in your vault. Its API key is OBSIDIANAPIKEY.
  • Periodic-note targets work natively on plugin v5.0.1 and earlier. From v5.0.2 they need the periodic-notes API extension; without it they fail with periodicunsupported`.

Setup documented for

Tools (14)

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 and reads are unscoped
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 (OBSIDIANDELETEELICITATION)
obsidian_open_in_uiOpen a file in the Obsidian app, optionally in a new pane
obsidian_list_commandsList command-palette commands (opt-in via OBSIDIANENABLECOMMANDS)
obsidian_execute_commandRun a command-palette command by ID (opt-in via OBSIDIANENABLECOMMANDS)

Tool names from the README, checked 16 Nov 2026.

obsidian-mcp-server compared with other Obsidian servers

ServerLicenceToolsLast commitStars
obsidian-mcp-serverApache-2.01411 Nov 2026706
obsidian-mcpMIT128 Oct 2026751

Every value is a checked fact on that server's own page. This is a comparison of facts, not a ranking.

Verified facts

Maintainer
cyanheads

Source · checked 16 Nov 2026

Licence
Apache-2.0

Source · checked 16 Nov 2026

Transport
  • stdio
  • streamable-http

Source · checked 16 Nov 2026

Required settings
Environment variables: OBSIDIAN_API_KEY

Source · checked 16 Nov 2026

Setup documented for
  • Claude Code

Source · checked 16 Nov 2026

Repository
github.com/cyanheads/obsidian-mcp-server

Source · checked 16 Nov 2026

Package
obsidian-mcp-server (npm)

Source · checked 16 Nov 2026

Latest version
3.9.0

Source · checked 16 Nov 2026

Last commit
11 Nov 2026

Source · checked 16 Nov 2026

GitHub stars
706

Source · checked 16 Nov 2026

Open issues
16

Source · checked 16 Nov 2026

Each value links to where it was found and shows the date it was checked. How we verify

Frequently asked questions

What does obsidian-mcp-server do?

Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.

Which MCP clients does obsidian-mcp-server document setup for?

Its README documents setup for Claude Code.

How do I install obsidian-mcp-server?

Add the install config shown on this page to your MCP client's configuration; the package is obsidian-mcp-server (npm). Check the README for client-specific steps.

What licence is obsidian-mcp-server under?

Apache-2.0, as reported by the repository on 16 Nov 2026.

Is obsidian-mcp-server still maintained?

The last commit was on 11 Nov 2026, and the repository had 16 open issues.

What settings does obsidian-mcp-server need?

Environment variables: OBSIDIAN_API_KEY.

What tools does obsidian-mcp-server expose?

14 tools: obsidian_get_note, obsidian_list_notes, obsidian_list_tags, obsidian_search_notes, obsidian_write_note, obsidian_append_to_note, obsidian_patch_note, obsidian_replace_in_note, obsidian_manage_frontmatter, obsidian_manage_tags, obsidian_delete_note, obsidian_open_in_ui, and more.

More Obsidian MCP servers