O

Obsidian Local REST

Bridge to Obsidian via the Local REST API plugin.

Works with: Claude DesktopCursor

Community server · details last checked

Quick install
npx -y obsidian-rest-mcp

How to install the Obsidian Local REST MCP server

Add this to your Claude Desktop MCP configuration:

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

Add this to your Cursor MCP configuration:

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

Built by ContextBoltThis directory is built by ContextBolt: MCP-native memory and SEO tools that run alongside Obsidian Local REST in the same client.

Explore ContextBolt

The Obsidian Local REST MCP server bridges an AI client to Obsidian through the Local REST API community plugin. It is one of several ways to get a vault in front of Claude, and the honest position is that it is not always the one you want.

What it actually does

The plugin exposes an HTTP API from inside Obsidian; this server translates that into MCP tools. The agent can read and write notes, use Obsidian’s own search rather than plain text matching, and reach features that live in the application rather than in the files: templates, the link graph, and plugin-provided behaviour.

Practical patterns:

  • ‘Search my vault for everything about this project, using Obsidian search syntax.’
  • ‘Create a note from my daily template and fill in today’s meetings.’
  • ‘What links to this note, and which of those are stale?‘

Why use it

The case for this over reading the folder directly is Obsidian’s own capabilities. Search that understands your syntax, templates that execute properly, and the link graph, which is genuinely useful and does not exist at the filesystem level. If your vault’s value is in its connections rather than its file contents, that difference matters.

Gotchas

For most people, the Filesystem server is the simpler answer: no plugin, no API key, no requirement that Obsidian be open, and it reads the same Markdown. Reach for this one when you have hit a specific feature you need. Obsidian must be running, which rules out headless or scheduled use. The API key grants full vault access, so treat it accordingly. And note that Local REST API 5.x started serving MCP directly, so check your plugin version first: you may not need a bridge at all.

Built by ContextBolt

This directory is built by ContextBolt

We build MCP-native tools that give your AI the context it cannot reach on its own. Bookmarks turns your saved posts into agent-queryable memory. SEO puts live keyword and ranking data inside Claude. Both run alongside Obsidian Local REST in the same client.

Explore the products →

Obsidian Local REST MCP server: FAQs

Do I still need this if I have Filesystem MCP?

Often not. Filesystem reads your vault's Markdown directly with no plugin and no key. Use this when you specifically need Obsidian's own search, templates or link graph.

Does Obsidian need to be running?

Yes. The plugin serves the API from inside the app, so a closed Obsidian means no connection.

Is the API key sensitive?

It grants access to your whole vault, so treat it as a real credential and keep it out of anything shared.

Has the plugin changed recently?

Version 5 of Local REST API began serving MCP itself, which makes a separate bridge unnecessary in some setups. Check your plugin version before installing anything.