Obsidian iCloud MCP

March 25, 2025 · View on GitHub

Connecting Obsidian Vaults that are stored in iCloud Drive to AI via the Model Context Protocol (MCP).

Warning

Obsidian iCloud MCP is fully tested on MacOS. If you are using Windows or Linux, please test it and let me know if it works.

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Debugging in Development

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "node",
      "args": [
        "/path/to/obsidian-mcp/build/index.js",
        "/Users/<USERNAME>/Library/Mobile\\ Documents/iCloud~md~obsidian/Documents/<VAULT_NAME_1>",
        "/Users/<USERNAME>/Library/Mobile\\ Documents/iCloud~md~obsidian/Documents/<VAULT_NAME_2>"
      ]
    }
  }
}

Using npx @modelcontextprotocol/inspector node path/to/server/index.js arg1 arg2 arg3 arg... to inspect servers locally developed.

Using in Production

{
  "mcpServers": {
    "obsidian-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp",
        "/Users/<USERNAME>/Library/Mobile\\ Documents/iCloud~md~obsidian/Documents/<VAULT_NAME_1>",
        "/Users/<USERNAME>/Library/Mobile\\ Documents/iCloud~md~obsidian/Documents/<VAULT_NAME_2>"
      ]
    }
  }
}