Obsidian MCP Setup

Obsidian MCP is a Model Context Protocol server that lets Claude read and write Obsidian notes.

GitHub: https://github.com/mauricio-wolff/mcp-obsidian

Prerequisites

• Node.js 18+
• Claude Code installed
• Obsidian vault (or any folder with markdown files)

Step 1: Create Vault

Create a folder for your notes:

mkdir ~/my-vault

Add some markdown files:

echo "# Welcome" > ~/my-vault/index.md

Step 2: Configure Claude

Edit ~/.claude.json:

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "@mauricio.wolff/mcp-obsidian@latest",
        "/home/ubuntu/my-vault"
      ]
    }
  }
}

Step 3: Restart Claude

Exit and restart Claude Code for changes to take effect.

Available Tools

Once configured, Claude can use these tools:

Tool	Description
read_note	Read a note by path
write_note	Create or overwrite a note
patch_note	Update part of a note
search_notes	Search notes by content
list_directory	List files in a folder
delete_note	Delete a note
move_note	Move or rename a note
manage_tags	Add, remove, or list tags
get_vault_stats	Get vault statistics

Usage Examples

Ask Claude:

• “Search my notes for ‘project ideas’”
• “Create a new note called ‘meeting-notes.md’”
• “What’s in my index.md file?”
• “List all notes in the projects folder”
• “Add tag important to my todo.md”

Vault Structure Tips

Organize your vault:

my-vault/
├── index.md           # Main page
├── daily/             # Daily notes
│   └── 2024-01-15.md
├── projects/          # Project docs
│   └── my-project.md
├── profiles/          # People info
│   └── john.md
└── templates/         # Note templates
    └── daily.md

Frontmatter

Use YAML frontmatter for metadata:

---
title: My Note
tags:
  - project
  - important
date: 2024-01-15
---
 
# My Note
 
Content here...

Tips

• Use [[wikilinks]] to connect notes
• MCP reads the vault folder you specify
• Changes are saved immediately
• Works with any markdown files, not just Obsidian