Obsidian MCP Server Configuration & Usage Guide

Supported Clients

• Claude Desktop
• Cursor

Installation Command

npx -y mcp-obsidian /path/to/vault

Configuration Example

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian",
        "/Users/you/ObsidianVault"
      ]
    }
  }
}

Permission Scope & Security Notes

可读写指定 Obsidian 笔记库中的文件

• file-read
• file-write

Risk Score：3/10

Common Errors

Vault 路径不存在

确认路径指向有效的 Obsidian Vault 目录

文件编码错误

确认笔记文件为 UTF-8 编码

Sources

• Official Documentation / Repository

Recently Verified：2026-05-18。Client versions and configuration formats may change. Please refer to official documentation before use.

Related Tools