icloud-drive-mcp

MCP server for managing iCloud Drive files via the local sync folder. Requires iCloud Drive installed and signed in.

• macOS: ~/Library/Mobile Documents/com~apple~CloudDocs/

• Windows: %USERPROFILE%\iCloudDrive (via the iCloud for Windows app)

Tools

• list_files — list files/directories under a path

• read_file — read a file's contents

• write_file — write/create a file

• delete_file — delete a file

• move_file — move/rename a file

• search_files — search for files by name pattern

• get_info — get metadata for a file or directory

All paths are resolved relative to, and sandboxed within, the iCloud Drive root.

Install as a Claude Code plugin

claude plugin marketplace add robworks-code/robworks-claude-code-plugins
claude plugin install icloud-drive-mcp@robworks-claude-code-plugins

Manual install

npm install
npm run build
claude mcp add icloud-drive-mcp -- node /path/to/icloud-drive-mcp/dist/index.js

Development

npm install
npm run build   # tsc -> dist/