Read-only MCP server for listing, searching, downloading, and reading iCloud Drive documents.
API-ключ
ICLOUD_USERNAME, ICLOUD_ROOT
Последняя проверка
2026-11-09
Звёзды
—
Инструменты
—
Аптайм
—
icloud-docs-mcp
Mail / Calendar / Contacts MCPs already exist. Drive is still the weak spot in the Apple stack if you are not on a Mac. That is the wedge: cross-platform Drive without needing a Mac. It is a utility, not a category.
It lists a folder, searches by filename, downloads files, and extracts text from common documents. There is no default Apple ID, no bundled documents, and no company-specific search logic.
Apple does not publish a third-party iCloud Drive API. This server uses the unofficial pyicloud library. You do not own that pipe. Apple can change an endpoint and this tool is down until someone reverse-engineers it again. Do not promise reliability this repo does not control.
Example:
Find the invoice in iCloud Drive and quote page 3.
What it is not
Not Mail, Calendar, Contacts, or Notes
Not a macOS-local Drive MCP (those already use Spotlight / ~/Library)
Not a hosted / HTTP MCP (it runs locally over stdio)
Not a 2FA prompt inside the model session
Not upload, rename, or delete
Not a reliability SLA. The unofficial client will break.
Disclaimer
This is not an Apple product. Apple does not publish a third-party iCloud Drive API. The unofficial client can break when Apple changes endpoints, and using it may conflict with Apple's terms. Use it at your own risk, locally, on an account you control.
Do not expose this server on the network. Cookiejar files are login credentials: never commit them, never paste them into issues, and never check in .env. See SECURITY.md.
The status tool returns the configured Apple ID and local cache paths so a client can tell whether login succeeded. It never returns a password.
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Вопросы
Как установить ICloud Drive Docs?
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
Нужен ли API-ключ для ICloud Drive Docs?
Издатель указывает следующие переменные окружения: ICLOUD_USERNAME, ICLOUD_ROOT.
Какой транспорт использует ICloud Drive Docs?
ICloud Drive Docs работает локально через stdio.
Когда ICloud Drive Docs проверялся в последний раз?
Последняя проверка: 2026-11-09. Read-only MCP server for listing, searching, downloading, and reading iCloud Drive documents.