Managing Your Obsidian Knowledge Base with Claude MCP (2026)

Setup and context — Why Obsidian + Claude MCP Changes Everything

Obsidian has become one of the most loved tools among developers, researchers, and knowledge workers. Its local-first, markdown-based design combined with bidirectional linking makes it a powerful "Second Brain" platform. But as vaults grow, finding the right notes, spotting connections, and keeping everything organized becomes increasingly time-consuming.

That's where Claude MCP (Model Context Protocol) comes in. By connecting Claude Code to your Obsidian vault through MCP, you gain an AI assistant that can read, write, search, and organize your notes on your behalf — turning your knowledge base into a truly intelligent, self-managing system.

What Is Obsidian MCP?

MCP (Model Context Protocol) is an open standard developed by Anthropic that lets AI tools like Claude Code securely access data and APIs from external applications. Think of it as a standardized "bridge" between Claude and the apps you use every day.

With an Obsidian MCP server running, Claude can:

• Read notes: Fetch content from specific files or entire vault directories
• Create and update notes: Write AI-generated content directly into your vault
• Search and filter: Query notes by keyword, tag, or date across the full vault
• Manage links: Suggest and create bidirectional links between related notes

In short, Claude becomes the librarian of your Second Brain — organizing, connecting, and expanding your knowledge base on demand.

Prerequisites

Before getting started, make sure you have:

• Claude Code: Version 1.x or later (check with claude --version)
• Obsidian: Latest version (the free plan works fine)
• Node.js: Version 18 or later
• An existing Obsidian vault (or create a new one)

If you haven't set up Claude Code yet, get the basics in place first. For a deeper understanding of how MCP works, check out MCP Practical Guide.

Back Up Your Vault First

Since Claude will be reading and writing to your vault via MCP, always create a backup before starting.

# Backup your vault with tar
tar -czf obsidian_vault_backup_$(date +%Y%m%d).tar.gz ~/Documents/MyVault/

Step 1: Install the Obsidian MCP Server

The most widely used community package is obsidian-mcp. Install it globally via npm.

# Install globally
npm install -g obsidian-mcp
 
# Verify installation
obsidian-mcp --version
# Expected output: obsidian-mcp v1.3.2

Find Your Vault Path

In Obsidian, go to Settings → About to find your vault's location. On macOS, it's typically under ~/Documents/ or in iCloud Drive at ~/Library/Mobile Documents/iCloud~md~obsidian/.

Step 2: Register the MCP Server in Claude Code

Open the Claude Code settings file at ~/.claude/settings.json and add the Obsidian MCP server configuration.

# Open the settings file
code ~/.claude/settings.json

Add the following to the mcpServers section:

{
  "mcpServers": {
    "obsidian": {
      "command": "obsidian-mcp",
      "args": [
        "--vault",
        "/Users/yourname/Documents/MyVault"
      ],
      "env": {}
    }
  }
}

Replace /Users/yourname/Documents/MyVault with the actual path to your vault.

Verify the Connection

Restart Claude Code and check that the MCP server is recognized.

# Launch Claude Code
claude
# Inside Claude Code, run:
# /mcp
# You should see: obsidian: connected

Step 3: Basic Usage

Once MCP is connected, you can interact with your vault using natural language inside Claude Code.

Read and Summarize Notes

You: Read all notes tagged "project-management" and summarize
     any currently active tasks.

Claude: Searching vault...
        Found 12 notes with the "project-management" tag.

        Active tasks summary:
        1. ✅ API documentation — in progress (notes/projects/api-docs.md)
        2. 🔄 User interview synthesis (notes/research/interviews.md)
        ...

Generate New Notes Automatically

You: Create an Obsidian note about the "Context Engineering" concept
     I studied today. Link it to my existing "AI Agents" note.

Claude: Note created:
        📄 notes/concepts/context-engineering.md

        Bidirectional link to [[AI Agents]] has been added.

Identify and Fix Orphaned Notes

You: Find all notes created in the past week that have no outbound
     links, and suggest connections to existing related notes.

Claude: Found 3 orphaned notes:
        - notes/tools/new-tool-discovery.md
          → Suggest linking to [[Development Tools Index]]
        ...

Step 4: Practical Workflow Examples

Here are some real-world workflows that illustrate the power of combining Obsidian with Claude MCP.

Workflow 1: Structured Book Notes

After reading a technical book, use Claude to transform rough highlights into a clean, structured note.

cat <<'EOF' | claude --print
Read notes/reading/clean-code-memo.md from my Obsidian vault
and rewrite it with the following structure, saving back to the
same file:
 
## Key Concepts
## Actionable Takeaways
## Links to Related Notes
## Application to My Current Projects
EOF

Workflow 2: Extract Action Items from Meeting Notes

cat <<'EOF' | claude --print
Read notes/meetings/2026-04-05-sprint-review.md,
extract all action items, and append them to
notes/tasks/sprint-actions.md.
Include the owner name and deadline for each task.
EOF

Workflow 3: Automated Weekly Review

cat <<'EOF' | claude --print
Review all notes created or updated this week (April 1–5, 2026)
and generate a weekly review document at notes/reviews/2026-W14.md
using this structure:
 
## What I Learned This Week
## Project Status Updates
## Focus Areas for Next Week
EOF

Step 5: Security and Access Control

It's important to think about how much access you give Claude over your vault.

Read-Only Mode

If your vault contains sensitive information, start with read-only access.

{
  "mcpServers": {
    "obsidian-readonly": {
      "command": "obsidian-mcp",
      "args": [
        "--vault", "/Users/yourname/Documents/MyVault",
        "--read-only"
      ]
    }
  }
}

Restrict Access to Specific Folders

You can grant access only to certain folders while keeping private notes out of reach.

{
  "mcpServers": {
    "obsidian-work": {
      "command": "obsidian-mcp",
      "args": [
        "--vault", "/Users/yourname/Documents/MyVault",
        "--include-folders", "notes/work,notes/public",
        "--exclude-folders", "notes/private,notes/diary"
      ]
    }
  }
}

Common Errors and Fixes

Error: Failed to connect to obsidian-mcp

The MCP server may not be running or the vault path may be incorrect.

# Run the server manually with debug output
obsidian-mcp --vault /path/to/vault --debug
 
# If the path contains spaces, quote it
obsidian-mcp --vault "/Users/yourname/My Vault"

Error: Permission denied reading vault

Check the file permissions on your vault directory.

# Check permissions
ls -la ~/Documents/MyVault/
 
# Fix read permissions if needed
chmod -R 755 ~/Documents/MyVault/

Error: Garbled characters in notes

If you're working with non-ASCII characters, set the encoding explicitly.

{
  "mcpServers": {
    "obsidian": {
      "command": "obsidian-mcp",
      "args": ["--vault", "/path/to/vault"],
      "env": {
        "LANG": "en_US.UTF-8",
        "LC_ALL": "en_US.UTF-8"
      }
    }
  }
}

Summary

Connecting Obsidian to Claude via MCP is one of the most practical ways to make your personal knowledge base genuinely intelligent. Here's a quick recap of what becomes possible:

• Instant retrieval: Ask Claude to surface the most relevant notes from thousands of entries
• Automatic organization: Let Claude restructure messy notes into clean, linked documents
• Continuous expansion: Use existing notes as context to generate new, well-integrated content
• Automated reviews: Set up weekly summaries and progress reports without lifting a finger

To go deeper on MCP, explore MCP Practical Guide. And if you're interested in giving Claude persistent, long-term memory across sessions, Claude Code Long-Term Memory with Engram MCP is a great next step.