Obsidian iCloud MCP

Obsidian iCloud MCP is an MCP server that connects Obsidian knowledge bases stored in iCloud Drive directly to AI assistants via the Model Context Protocol. Built specifically for users who sync their Obsidian notes across Apple devices using iCloud Drive, this integration allows AI clients to access, read, and manage markdown documents across one or more designated vaults. Knowledge workers, researchers, and writers who maintain their personal knowledge management systems in Obsidian can use this tool to query their notes, synthesize personal documentation, and generate new content based on existing vault context. Because Obsidian vaults in iCloud are stored in local macOS file directories, the server bridges the local filesystem path with AI models without requiring manual file copying or external cloud export plugins. It enables automated searching across multiple vaults, note retrieval, and direct integration between personal markdown archives and conversational AI environments. The server is primarily designed and tested for macOS environments where iCloud Drive folder hierarchies are readily accessible through standard local file paths.

Category: Files, Documents & PDFs

Tags: filesystem, icloud, markdown, notes, obsidian

Visit Obsidian iCloud MCP

How to install and configure Obsidian iCloud MCP

1. Open your Claude Desktop configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json. 2. Add the obsidian-mcp entry under the mcpServers object with your vault paths: json { "mcpServers": { "obsidian-mcp": { "command": "npx", "args": [ "-y", "obsidian-mcp", "/Users/<USERNAME>/Library/Mobile Documents/iCloud~md~obsidian/Documents/<VAULT_NAME_1>" ] } } } 3. Replace <USERNAME> with your macOS user account name and <VAULT_NAME_1> with your vault folder name. 4. Save the configuration file and restart Claude Desktop.

What you can do with Obsidian iCloud MCP

• Searching across multiple iCloud-stored Obsidian vaults to retrieve specific research references, meeting logs, and personal journal entries. * Synthesizing connections between existing markdown notes to draft comprehensive summaries and outlines directly inside your AI client. * Prompting an AI assistant to analyze project notes and extract actionable to-do items from your iCloud Obsidian documentation. * Updating and organizing note contents in Obsidian vaults without manually switching out of the AI desktop interface.

Key facts

• https://github.com/YanceyOfficial/obsidian-mcp
• Files, Documents & PDFs, Notes & Knowledge Management
• filesystem, icloud, markdown, notes, obsidian

Part of MCP Servers

What can Obsidian iCloud MCP do?

Obsidian iCloud MCP connects your local iCloud-stored Obsidian vaults to Model Context Protocol clients like Claude Desktop. It allows AI models to browse, inspect, and retrieve information from your markdown notes across multiple configured vaults, facilitating deep context retrieval and personal knowledge queries.

How do I install Obsidian iCloud MCP?

To install Obsidian iCloud MCP, configure your Claude Desktop settings file with an entry for obsidian-mcp using npx. Provide the exact local filesystem paths to your iCloud Obsidian vaults as arguments, save the JSON configuration file, and restart the Claude Desktop application.

Which operating systems are supported by Obsidian iCloud MCP?

Obsidian iCloud MCP is fully tested and supported on macOS, where iCloud Drive directories follow the standard Mobile Documents path convention. While the server may theoretically run on Windows or Linux, those platforms have not been verified by the developer and require testing.

Which MCP clients work with Obsidian iCloud MCP?

Obsidian iCloud MCP works directly with Claude Desktop by configuring its JSON settings file. It can also be inspected and tested locally using the official Model Context Protocol inspector tool or run in any custom MCP client that supports standard node-based local process execution.