Claude in Obsidian | Plugins, MCP & Claude Code Integration 2026

What Is Claude in Obsidian — What Can the Integration Do?

Obsidian is a note-taking app that manages local Markdown files as a Vault. Because all notes are plain text, they pair extremely well with Claude's file read/write capabilities, allowing natural language instructions like "read my notes and suggest ideas," "categorize and organize notes," or "draft a new note."

As of 2026, the four main integration methods are:

Method ① Claude Desktop Filesystem Connector (Fastest, Free Plan Supported)

The simplest approach is to use the Filesystem connector built into Claude Desktop. According to an XDA Developers review, it "takes just 3 clicks to set up," with no manual MCP server configuration required.

Setup steps:

1. Open Claude Desktop and go to Settings → Connectors
2. Select Filesystem and install it
3. Specify the folder path of your Obsidian Vault and save

Once configured, you can read and write all Markdown files in your Vault from Claude's chat interface. Natural language instructions like "find notes related to X from what I wrote last week" or "categorize the notes in this folder by theme" work right away.

Source: I hooked up Claude to Obsidian without setting up MCP, and I should have done it sooner — XDA Developers

Method ② Claudian Plugin — Launch Claude Code Natively Inside Obsidian

Claudian is an open-source plugin that embeds Claude Code directly inside your Obsidian Vault. Your Vault becomes Claude Code's working directory, and you can read, write, search notes, and run multi-step tasks from Obsidian's side panel.

Key features:

• Inline editing: Select text and press a hotkey to edit directly with word-level diff display
• Slash commands (/): Access reusable prompt templates
• Mentions (@): Reference specific notes using @notename or @[[note name]] syntax
• Plan mode (Shift+Tab): Review and approve what will happen before execution

Installation steps:

1. Download main.js, manifest.json, and styles.css from the GitHub releases page
2. Create a .obsidian/plugins/claudian/ folder inside your Vault and copy the files there
3. Enable the plugin in Obsidian's settings

Prerequisites: Claude Code CLI must be installed locally, plus an Anthropic or compatible provider subscription.

Source: GitHub — YishenTu/claudian

Method ③ Agent Client Plugin — Manage Claude Code, Codex & Gemini CLI in One Place

Agent Client (formerly obsidian-agent-client) is a plugin that lets you use multiple AI tools inside Obsidian — including Claude Code, Codex, and Gemini CLI. It is featured in an official thread on the Obsidian Forum and, as of May 2026, is pending submission to the community plugin store. You can install it early via the BRAT plugin.

Key features:

• Vault-aware conversations: Automatically includes current note context using @notename syntax
• Terminal command execution: Supports Bash operations and MCP tool integration
• Thread management: Organize and export multiple conversation sessions

This is ideal for users who want to switch between different AI tools by use case, or who want to manage Claude Code and other tools in a unified Obsidian interface.

Source: New Plugin: Agent Client — Obsidian Forum

Method ④ Claude Code × Symbolic Links — Advanced Developer Integration

For users who use Claude Code as their primary development tool, building a dedicated Developer Vault with symbolic links is the most flexible approach. The Starmorph Blog integration guide describes this as "the simplest and most recommended strategy."

Example setup:

mkdir ~/Developer-Vault
ln -s ~/.claude claude-global
ln -s ~/projects/my-app my-app

By aggregating symbolic links to multiple projects in a Developer Vault, Obsidian's cross-vault search, Graph view, and Dataview queries can function across all your projects.

Preventing file clutter:

To keep development files from mixing into your Vault, set ignore filters in .obsidian/app.json:

"userIgnoreFilters": ["node_modules/", ".next/", "dist/"]

Combining with Dataview:

Add frontmatter to each project's CLAUDE.md to view a dashboard of all project configurations with a Dataview query:

---
type: claude-config
project: my-app
status: active
---

Source: Obsidian + Claude Code: The Complete Integration Guide — Starmorph Blog

5 Practical Use Cases

1. Automatic note categorization Just say "sort all the notes in this folder into subfolders by theme," and Claude reads the content and organizes it automatically.

2. Cross-vault research search While researching, ask "find all notes in my Vault related to X" and Claude searches across notes and returns a summary.

3. Automated daily review generation A popular workflow: pass the unprocessed notes from your inbox folder to Claude each day and ask it to "summarize today's action items."

4. Link suggestions between notes Show Claude your existing notes and ask it to "suggest other notes this should link to" — it returns link candidates to increase your Graph density.

5. Draft generation → save to Vault You can complete a full workflow like "create an overview note about X and save it to the X folder in my Vault" entirely in natural language.

Caveats and Risk Management

Wikilink breakage risk (especially with Method ①)

When you move or rename files through the Filesystem connector, Obsidian's [[wikilink]] references are not automatically updated. This is because Claude operates on files at the OS level and is unaware of Obsidian's internal link management.

Safe usage guidelines:

• Limit Claude's write access to new drafts and inbox notes only
• Do not let Claude directly edit notes with many links concentrated in Graph view
• Always perform renames and moves through Obsidian's UI (or an Obsidian MCP server)

For Claude Code plugins (Methods ② and ③):

Claude Code CLI installation and an Anthropic subscription are required. For free plan users, Method ① (the Desktop connector) is the best choice.

Recommended security settings:

If your Vault contains sensitive information (passwords, API keys, etc.), restrict the read path in the connector settings to specific folders, or configure exclusion rules equivalent to .claudeignore.

Quick Reference: Method vs. Plan

If you are not using Claude Code, Method ① — the Filesystem connector — is the fastest and most affordable option. When you find yourself needing more advanced Vault automation or deep inline editing, that's the natural time to consider moving to the Claudian or Agent Client plugins.

Summary

As of 2026, integrating Claude with Obsidian is possible at four different difficulty levels. Even free plan users can connect their Vault in 3 clicks using Claude Desktop's Filesystem connector, immediately enabling note search, categorization, and draft generation. Claude Code users can achieve deeper native integration with the Claudian or Agent Client plugins, which shine for organizing large Vaults or managing development documentation.

The recommended path is to start with the Filesystem connector, and step up to Claude Code integration when you want more power.