icloud-drive-mcp

로컬 동기화 폴더를 통해 iCloud Drive 파일을 관리하기 위한 MCP 서버입니다. iCloud Drive가 설치 및 로그인되어 있어야 합니다.

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

• Windows: %USERPROFILE%\iCloudDrive (Windows용 iCloud 앱을 통해)

도구

• list_files — 경로 아래의 파일/디렉터리 나열

• read_file — 파일 내용 읽기

• write_file — 파일 쓰기/생성

• delete_file — 파일 삭제

• move_file — 파일 이동/이름 변경

• search_files — 이름 패턴으로 파일 검색

• get_info — 파일 또는 디렉터리의 메타데이터 가져오기

모든 경로는 iCloud Drive 루트를 기준으로 확인되며, 해당 루트 내에서만 접근이 제한됩니다.

Related MCP server: Google Drive MCP Server

Claude Code 플러그인으로 설치

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

수동 설치

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

개발

npm install
npm run build   # tsc -> dist/