Read-only MCP server for listing, searching, downloading, and reading iCloud Drive documents.
Clave de API
ICLOUD_USERNAME, ICLOUD_ROOT
Última comprobación
2026-11-09
Estrellas
—
Herramientas
—
Disponibilidad
—
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.
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo ICloud Drive Docs?
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿ICloud Drive Docs necesita una clave de API?
El publicador indica estas variables de entorno: ICLOUD_USERNAME, ICLOUD_ROOT.
¿Qué transporte usa ICloud Drive Docs?
ICloud Drive Docs se ejecuta localmente por stdio.
¿Cuándo se comprobó ICloud Drive Docs por última vez?
Última comprobación: 2026-11-09. Read-only MCP server for listing, searching, downloading, and reading iCloud Drive documents.