← Back to Journal

Accessing Obsidian Notes with Claude

Connecting Claude Desktop directly to your Obsidian vault via the MCP Tools plugin - let the AI read, search, and generate local notes natively.

ai 2 min read

Connecting Claude Desktop directly to an Obsidian vault changes how you use AI for note-taking. Instead of copying and pasting text into a web browser, you give Claude the ability to securely read, search, and write your actual files.

What You Can Do

When Claude is connected to your vault, it acts as a hands-on assistant:

  • Direct File Writing: Ask Claude to create a new note, add a paragraph to your daily journal, or apply an Obsidian template - all through natural conversation.
  • Contextual Search: Tell Claude to find specific concepts across your entire vault (e.g., “Find everything I wrote about project management last month”).
  • Synthesize Information: Have Claude read scattered notes on a topic and combine them into a single, organized summary note.

Setting up this bridge requires a specific plugin stack and configuration. Here is exactly how to do it.

Required Plugin Stack

Open your Obsidian Settings, navigate to Community Plugins, and install the following:

Required:

  • MCP Tools (by jacksteamdev): The main bridge that connects Claude to your vault.
  • Local REST API: Creates the local web server that allows the MCP bridge to communicate with Obsidian.

Highly Recommended:

  • Smart Connections: MCP Tools uses this to enable “semantic search,” letting Claude find notes by underlying concepts rather than just exact keyword matches.
  • Templater: Allows Claude to automatically format new notes using your existing Obsidian templates.

Make sure all installed plugins are enabled before proceeding.

Step 1: Configure the Local REST API

The MCP Tools plugin cannot function without the Local REST API acting as its messenger. You must configure it first.

  1. Go to Settings > Local REST API.
  2. Toggle ON the setting for Enable Non-encrypted (HTTP) Server.
    • Note: Using the unsecure local HTTP URL is highly recommended here. Using the secure HTTPS version often causes self-signed certificate errors that block the MCP server from working.

Step 2: The Obsidian Restart “Gotcha”

Do not skip this step. Once the Local REST API is configured and enabled, you must completely restart Obsidian.

Close the application entirely and reopen it. If you try to configure the MCP Tools plugin before doing this, it will refuse to install the server and will fail without giving you a clear error message.

Step 3: Configure and Install MCP Tools

Now that Obsidian has been restarted and the REST API is actively running:

  1. Go to Settings > MCP Tools.
  2. Click the Install Server button.

The plugin will now download the necessary server files and automatically update Claude Desktop’s underlying configuration file (claude_desktop_config.json) with your vault’s connection details. You will see obsidian-mcp-tools connector in claude.

Related reading