mcp-obsidian-tools

Obsidian Model Context Protocol (Write-Enabled)

This is an enhanced version of the original mcp-obsidian that adds write and append capabilities to allow Claude Desktop (or any MCP client) to read, search, write, and modify any directory containing Markdown notes (such as an Obsidian vault).

New Features

• ✅ write_note: Create or overwrite notes
• ✅ append_note: Append content to existing notes
• ✅ All original read/search functionality preserved
• ✅ Automatic parent directory creation
• ✅ Same security model as original

Credits

Based on the original mcp-obsidian by Henry Mao.

Installation

Make sure Claude Desktop and npm is installed.

Installing via NPX (Recommended)

To install and run the enhanced version with write capabilities:

npx mcp-obsidian-tools /path/to/your/vault

For Claude Desktop, add to your MCP settings:

{
  "mcpServers": {
    "obsidian-tools": {
      "command": "npx",
      "args": ["-y", "mcp-obsidian-tools", "/path/to/your/vault"]
    }
  }
}

Then, restart Claude Desktop and you should see the following MCP tools listed:

Usage with VS Code

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).

Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.

Note that the mcp key is not needed in the .vscode/mcp.json file.

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "vaultPath",
        "description": "Path to Obsidian vault"
      }
    ],
    "servers": {
      "obsidian-tools": {
        "command": "npx",
        "args": ["-y", "mcp-obsidian-tools", "${input:vaultPath}"]
      }
    }
  }
}

Available Tools

This enhanced version provides 9 tools:

Core Operations

• read_notes - Read contents of multiple notes
• search_notes - Search for notes by name/pattern
• write_note - Create or overwrite a note with content
• append_note - Append content to an existing note

Advanced Features

• extract_links - Extract all wiki links and markdown links from a note
• find_backlinks - Find all notes that link to a specific note
• extract_metadata - Extract frontmatter, inline fields, and tags from a note
• search_by_tags - Search for notes containing specific tags
• create_link - Create or update a wiki link from one note to another

Tool Usage Examples

Basic Operations

// Create a new note
write_note({
  path: "daily/2024-01-15.md",
  content: "# Daily Note\n\nToday's tasks:\n- Review code"
})

// Append to existing note
append_note({
  path: "daily/2024-01-15.md", 
  content: "\n\n## Evening Reflection\nCompleted code review successfully."
})

// Read multiple notes
read_notes({
  paths: ["daily/2024-01-15.md", "projects/project-a.md"]
})

// Search for notes
search_notes({
  query: "project"
})

Advanced Operations

// Extract all links from a note
extract_links({
  path: "projects/project-a.md"
})

// Find all notes linking to this note
find_backlinks({
  path: "concepts/important-concept.md"
})

// Extract metadata (frontmatter, tags, inline fields)
extract_metadata({
  path: "projects/project-a.md"
})

// Search by tags
search_by_tags({
  tags: ["project", "active"],
  matchAll: true  // require both tags
})

// Create a link between notes
create_link({
  fromPath: "daily/2024-01-15.md",
  toPath: "projects/project-a.md",
  linkText: "Project A Details"  // optional
})