Obsidian

Query and edit your Obsidian vault from any MCP client.

Works with: Claude DesktopClaude CodeCursorCline
Quick install
npx -y obsidian-mcp

How to install the Obsidian MCP server

Add this to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp"
      ]
    }
  }
}

Add this to your Claude Code MCP configuration:

npx -y obsidian-mcp

Add this to your Cursor MCP configuration:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp"
      ]
    }
  }
}

Add this to your Cline MCP configuration:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp"
      ]
    }
  }
}

The Obsidian MCP server gives Claude full access to your Obsidian vault. Search notes, follow wikilinks, read daily notes, write new ones. For knowledge-management nerds, this is the tightest integration between Obsidian’s structured-but-personal note-taking and Claude’s reasoning.

Why use it

Obsidian is where many second-brain workflows live. The challenge is retrieval: 5,000 notes is a lot to hold in your head. Claude with the Obsidian MCP becomes a librarian for your vault, surfacing what’s relevant and even writing new notes that link to what’s there.

For solo workers maintaining a long-running vault, this is the upgrade that makes the vault feel alive instead of buried.

What it actually does

Search notes by content or tag, read note bodies, list daily notes, follow wikilinks, create new notes, append to existing notes, update frontmatter. The exact surface depends on which Obsidian MCP server you choose.

Practical patterns:

  • “Find every note in my vault about deep work and summarize the patterns I’ve recorded.”
  • “Create a daily note for today with these meeting notes.”
  • “What did I write last month about ContextBolt’s pricing strategy?”

Gotchas

Local REST plugin must be running. If you close Obsidian, the MCP server returns errors until you reopen. Configure Obsidian to start at login if you rely on this daily.

Vault paths are absolute. The MCP only sees the vault Local REST is configured for. If you have multiple vaults, run separate MCP instances or pick the one you use most for AI workflows.

Pair with ContextBolt for two-layer memory: ContextBolt for bookmarks captured automatically, Obsidian for notes you’ve explicitly written. Claude can pull from both in one prompt.

Example prompts for the Obsidian MCP server

Find every note in my vault about deep work.

Create a new daily note for today with meeting agenda.

Update the 'Reading List' note with this article.

Obsidian MCP server: FAQs

Does it work with the Obsidian Local REST plugin?

Yes. The most reliable Obsidian MCP servers wrap the Local REST API plugin. Install Local REST inside Obsidian first, generate an API key, then point the MCP server at it.

Can Claude write to my vault?

Yes. With write enabled, Claude can create notes, append to existing notes, and update frontmatter. Default to read for safety; expand only when you trust the workflow.

Does it understand wikilinks?

Yes. The server resolves [[wikilinks]] and can return note connections. Useful for graph-style queries across your vault.

How does it differ from native Obsidian search?

Native Obsidian search is keyword-only and surfaces matching notes. Claude with the MCP can synthesise across notes, summarize topics, and write back as new notes. It's a layer on top, not a replacement.

Will it sync across devices?

The MCP runs on whatever machine has Obsidian Local REST running. If you sync your vault via Obsidian Sync, iCloud, or Git, the changes propagate. The MCP itself doesn't sync.