Read-only MCP server for listing, searching, downloading, and reading iCloud Drive documents.
Chave de API
ICLOUD_USERNAME, ICLOUD_ROOT
Última verificação
2026-11-09
Estrelas
—
Ferramentas
—
Disponibilidade
—
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.
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo ICloud Drive Docs?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
ICloud Drive Docs precisa de uma chave de API?
O publicador lista estas variáveis de ambiente: ICLOUD_USERNAME, ICLOUD_ROOT.
Qual transporte ICloud Drive Docs usa?
ICloud Drive Docs roda localmente via stdio.
Quando ICloud Drive Docs foi verificado pela última vez?
Última verificação: 2026-11-09. Read-only MCP server for listing, searching, downloading, and reading iCloud Drive documents.