Skip to content

obsidian-mcp

MIT★ 751updated 8 Oct 2026

A simple MCP server for Obsidian

What can you do with obsidian-mcp?

  • obsidian_list_vaults — List configured vault ids without exposing host paths.
  • obsidian_read_note — Read a bounded page of a note and return its SHA-256 etag.
  • obsidian_create_note — Atomically create a note without overwriting.
  • obsidian_edit_note — Append, prepend, or replace exact note content.
  • obsidian_delete_note — Move a note to MCP trash or permanently delete it with explicit confirmation.
  • obsidian_move_note — Move or rename a note and update unambiguous backlinks transactionally.

Tool descriptions from the project's README, checked 16 Nov 2026.

About obsidian-mcp

A local Model Context Protocol server that lets MCP-compatible assistants safely read and modify explicitly configured Obsidian vaults. Version 2 supports both MCP 2026-07-28 and 2025-era clients by default, and requires Node.js 22 or newer. It works directly with Markdown files, so Obsidian does not need to be open. Legacy protocol and v1 positional-path compatibility are deprecated and print exact migration instructions to stderr.

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

Install

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp@2",
        "serve",
        "--vault",
        "notes=/absolute/path/to/vault"
      ]
    }
  }
}

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.

Tools (12)

obsidian_list_vaultsList configured vault ids without exposing host paths.
obsidian_read_noteRead a bounded page of a note and return its SHA-256 etag.
obsidian_create_noteAtomically create a note without overwriting.
obsidian_edit_noteAppend, prepend, or replace exact note content.
obsidian_delete_noteMove a note to MCP trash or permanently delete it with explicit confirmation.
obsidian_move_noteMove or rename a note and update unambiguous backlinks transactionally.
obsidian_create_directoryTransactionally create a directory inside a vault.
obsidian_search_vaultSearch content, filenames, or tags with bounded cursor pagination.
obsidian_add_tagsAdd tags to one or more notes atomically.
obsidian_remove_tagsRemove exact, nested, or wildcard-selected tags atomically.
obsidian_rename_tagRename a tag across the vault atomically.
obsidian_manage_tagsUnified add/remove tag workflow using the same implementation.

Tool names from the README, checked 16 Nov 2026.

obsidian-mcp compared with other Obsidian servers

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

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

Verified facts

Maintainer
StevenStavrakis

Source · checked 16 Nov 2026

Licence
MIT

Source · checked 16 Nov 2026

Repository
github.com/StevenStavrakis/obsidian-mcp

Source · checked 16 Nov 2026

Last commit
8 Oct 2026

Source · checked 16 Nov 2026

GitHub stars
751

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 do?

A simple MCP server for Obsidian

How do I install obsidian-mcp?

Add the install config shown on this page to your MCP client's configuration. Check the README for client-specific steps.

What licence is obsidian-mcp under?

MIT, as reported by the repository on 16 Nov 2026.

Is obsidian-mcp still maintained?

The last commit was on 8 Oct 2026, and the repository had 16 open issues.

What tools does obsidian-mcp expose?

12 tools: obsidian_list_vaults, obsidian_read_note, obsidian_create_note, obsidian_edit_note, obsidian_delete_note, obsidian_move_note, obsidian_create_directory, obsidian_search_vault, obsidian_add_tags, obsidian_remove_tags, obsidian_rename_tag, obsidian_manage_tags.

More Obsidian MCP servers