Obsidian Icloud

🚀 Obsidian iCloud MCP

Connect Obsidian vaults stored in iCloud Drive to AI and communicate via the Model Context Protocol (MCP).

🚀 Quick Start

✨ Features

Connect Obsidian vaults stored in iCloud Drive to AI, enabling communication through the Model Context Protocol (MCP).

⚠️ Important Note

Obsidian iCloud MCP has been fully tested on MacOS. If you are using Windows or Linux, please test it yourself and let me know the results.

💻 Usage Examples

Usage with Claude Desktop

Add the following content to your claude_desktop_config.json:

Basic Usage

{
  "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>"
      ]
    }
  }
}

Use npx @modelcontextprotocol/inspector node path/to/server/index.js arg1 arg2 arg3 arg... to locally check the server under development.

Advanced Usage

{
  "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>"
      ]
    }
  }
}