MCP Obsidian vs Obsidian MCP Pro

A side-by-side look at the MCP Obsidian and Obsidian MCP Pro MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.

MCP Obsidian logoMCP ObsidianKnowledge & Memory · Local subprocess (stdio)MCP server that interacts with Obsidian via the Obsidian rest API community plugin48FairAuth: api key requiredObsidian MCP Pro logoObsidian MCP ProKnowledge & Memory · Local subprocess (stdio)Feature-complete Obsidian vault MCP server with 23 tools and 3 resources. Full-text search, note CRUD, frontmatter queries, tag management, backlinks, graph traversal (BFS up to 5 hops), orphan/broken link detection, and canvas support. Auto-detects vault, path traversal protection, MIT licensed.67GreatAuth: no auth required

Verdict: choose MCP Obsidian for knowledge & memory work as a local process; choose Obsidian MCP Pro for knowledge & memory as a local process. You can also run both side by side in one mcpServers block.

Which MCP server should you choose?

MCP Obsidian logoChoose MCP Obsidian when

  • You need dedicated capabilities in the Knowledge & Memory domain.
  • You prefer a local stdio subprocess transport.
  • Its auth model fits you: API key required.
  • You have the keys it needs: OBSIDIAN_API_KEY.
Explore MCP Obsidian

Obsidian MCP Pro logoChoose Obsidian MCP Pro when

  • You need dedicated capabilities in the Knowledge & Memory domain.
  • You prefer a local stdio subprocess transport.
  • Its auth model fits you: No auth required.
  • You have the keys it needs: OBSIDIAN_VAULT_PATH, OBSIDIAN_READ_PATHS, OBSIDIAN_WRITE_PATHS.
  • You want tools like search_notes, get_note, list_notes.
Explore Obsidian MCP Pro

Feature & specification comparison

Rows where the two servers differ are marked.

SpecMCP Obsidian logoMCP ObsidianObsidian MCP Pro logoObsidian MCP Pro
CategoryKnowledge & MemoryKnowledge & Memory
Quality signal48/100 · Fair67/100 · Great
Install commandConfirmedConfirmed
TransportLocal subprocess (stdio)Local subprocess (stdio)
AuthAPI key requiredNo auth required
PricingFreeFree
Required env varsOBSIDIAN_API_KEYOBSIDIAN_VAULT_PATHOBSIDIAN_READ_PATHSOBSIDIAN_WRITE_PATHS
Verified ownerCommunity listingCommunity listing
GitHub stars4,50333
Directory activity 9 views 0 installs 0 upvotes 1 views 0 installs 0 upvotes
ToolsNot listed41

Tools & capabilities

MCP Obsidian tools

No tool names declared yet. Check the project README from the listing page.

Obsidian MCP Pro tools 41

  • search_notesFull-text search across all notes in the vault. Ranks literal matches with title/path focus and repeated-line dampening, then returns matching note paths grouped with the line numbers and query-centered snippet content of each matching line. Use to locate notes containing a phrase, keyword, or code fragment; pair with get_note to retrieve full bodies.
  • get_noteRead a note in full or as a fragment. With no fragment options, returns parsed frontmatter (as a labeled header), a flat list of inline #tags, and the body. With `section`, returns just the body under that heading (path-form like 'Tasks/Today' is supported). With `block`, returns the paragraph or block tagged `^id`. With `lines`, returns the inclusive 1-indexed line range. Fragment modes skip the frontmatter/tag header and return raw text — use them to keep token usage tight on long notes.
  • list_notesEnumerate every markdown note in the vault (or a single folder), returning a sorted list of relative paths along with the total count. Truncates output to `limit` entries but still reports the total. Use to browse vault structure, build a file picker, or enumerate targets for batch processing.
  • get_daily_noteRead the daily note for today or for a specific date, resolved via the vault's configured daily-note folder and filename format. Returns the note path, parsed frontmatter (as a labeled header block), and body. Errors if no daily note exists for that date — use create_daily_note to create one.
  • search_by_frontmatterFind notes whose YAML frontmatter contains a given property/value pair. Property names and values are matched case-insensitively; for array-valued properties, a match is declared if any element matches. Returns matching note paths with their full frontmatter. Use to filter notes by metadata like status, type, or tags stored in frontmatter.
  • get_recent_notesList notes ordered by most-recently-modified first. Optional `since` filter accepts an ISO date (e.g. '2026-04-01') or a relative span ('7d', '24h', '2w'); only notes modified at or after that time are returned. Use to surface what you've been working on, build a 'what changed this week' digest, or pick targets for review.
  • get_vault_statsReturn a quick health snapshot of the vault: note count, total bytes, total words, unique tag count, untagged-note count, and the most-recently-modified note. Useful for dashboards and 'is this vault healthy?' checks. Reads through the mtime cache so repeat calls are cheap.
  • resolve_aliasFind every note whose frontmatter `aliases:` field contains the given name (case-insensitive). With `includeBasename: true`, also matches notes whose filename (without `.md`) equals the name — Obsidian's resolution fallback when no alias matches. Use to translate a human-friendly title like 'My Project' into the actual note path before calling get_note.
  • create_noteCreate a new markdown note at the given path with body content and optional YAML frontmatter. Fails (does not overwrite) if a note already exists at that path — use append_to_note, prepend_to_note, or update_frontmatter for existing notes. Missing directories are created automatically, and a .md extension is appended if omitted.
  • append_to_noteAppend text to the end of an existing note without altering prior content. By default, inserts a leading newline if the file does not already end in one, so appended content starts on its own line. Use for log entries, running lists, or adding new sections. Fails if the note does not exist — use create_note to make a new note first.
  • prepend_to_noteInsert content at the top of an existing note's body, immediately after the YAML frontmatter block if one is present (so metadata stays at the top of the file). Use for adding new items to the front of a running list, pinning context, or inserting TL;DR sections. Fails if the note does not exist.
  • update_frontmatterMerge new key-value pairs into a note's YAML frontmatter, preserving any keys not mentioned and leaving the body content untouched. Keys in the payload overwrite existing values. Creates a frontmatter block if the note has none. Returns a count of properties written. Use to set status fields, tags arrays, or other metadata without rewriting the body. Note: The YAML block is regenerated on each update — comments, custom quoting, multi-line scalar style, blank lines, and key ordering inside the block are normalized. Key *presence and values* are preserved; formatting is not.
  • +29 more on the listing page

Ready-to-paste client configs

Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.

MCP Obsidian

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "markuspfundstein-mcp-obsidian": {
      "command": "uvx",
      "args": [
        "mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "YOUR_OBSIDIAN_API_KEY_HERE"
      }
    }
  }
}

Obsidian MCP Pro

mcpServers (Claude Desktop / Cursor)
{
  "mcpServers": {
    "rps321321-obsidian-mcp-pro": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-pro"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "YOUR_OBSIDIAN_VAULT_PATH_HERE",
        "OBSIDIAN_READ_PATHS": "YOUR_OBSIDIAN_READ_PATHS_HERE",
        "OBSIDIAN_WRITE_PATHS": "YOUR_OBSIDIAN_WRITE_PATHS_HERE"
      }
    }
  }
}

Frequently asked questions

MCP Obsidian is categorized under Knowledge & Memory and uses a local stdio subprocess. Obsidian MCP Pro belongs to Knowledge & Memory and uses a local stdio subprocess. Pick MCP Obsidian for knowledge & memory work and Obsidian MCP Pro for knowledge & memory.

Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.

MCP Obsidian is listed as free. Auth: api key required. Obsidian MCP Pro is listed as free. Auth: no auth required. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.

Yes. MCP clients support multiple servers: add markuspfundstein-mcp-obsidian and rps321321-obsidian-mcp-pro as separate keys in the same mcpServers object, and your assistant will call tools from either one.

On AllMCPs, MCP Obsidian has a quality signal of 48/100 (Fair) with 9 views, 0 installs and 4,503 GitHub stars. Obsidian MCP Pro has 67/100 (Great) with 1 views, 0 installs and 33 GitHub stars.