All How-To Guides

3 Ways to Use Obsidian with Claude Code

How to use Obsidian with Claude Code?

3 MCP servers featured

Obsidian is a powerful knowledge management tool with local Markdown files. MCP servers can connect Claude to your Obsidian vault for note access, search, and knowledge retrieval. Here are the best options for Obsidian integration.

Recommended MCP Servers

Obsidian MCP

MarkusPfundstein/mcp-obsidian

>3k

Connect to Obsidian vaults via the Local REST API for note reading and writing.

Key Features

  • Read and write notes
  • Search vault contents
  • Access note metadata
  • Create and update notes

Installation

npx obsidian-mcp

The Obsidian MCP provides comprehensive vault access through the Local REST API. Search your knowledge base, read notes, and create new content. Perfect for using Obsidian as Claude's memory.

Best for: Obsidian power users View on GitHub

Filesystem MCP

anthropics/mcp-server-filesystem

>2k

Direct access to Obsidian vault files since they're just Markdown.

Key Features

  • Direct file access
  • Read any note
  • Create and edit notes
  • Works with any vault

Installation

npx @modelcontextprotocol/server-filesystem /path/to/vault

Since Obsidian vaults are just folders of Markdown files, the Filesystem MCP works directly. No Obsidian plugin required—just point it at your vault folder. Simple and effective.

Best for: Basic vault access View on GitHub

Obsidian MCP Server

cyanheads/obsidian-mcp-server

>300

Native Obsidian plugin that exposes vault as an MCP server.

Key Features

  • Native plugin integration
  • Vault search
  • Note operations
  • Obsidian API access

Installation

Install via Obsidian Community Plugins

This Obsidian plugin runs an MCP server directly from within Obsidian. Install it like any community plugin for seamless integration. Good for users who prefer native Obsidian solutions.

Best for: Plugin-based workflows View on GitHub

Quick Comparison

MCPStarsBest ForProsCons
Obsidian MCP>2.7kPower usersFull API accessREST API required
Filesystem MCP>2kSimple accessNo plugin neededLimited features
Obsidian MCP Server>300Native integrationObsidian-nativePlugin management

Getting Started

To use Obsidian with Claude Code:

  1. For simple access, use Filesystem MCP with your vault path:

    npx @modelcontextprotocol/server-filesystem /path/to/obsidian/vault
    
  2. For full integration, install the Obsidian Local REST API plugin and the Obsidian MCP.

Example prompt: "Search my Obsidian vault for notes about project management and summarize the key points."

Related Guides