# 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/
```