icloud-docs-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ICLOUD_ROOT | No | Drive folder prefix; all tools are limited to this scope. | |
| ICLOUD_PASSWORD | No | Login CLI prompts if unset. Avoid putting this in the MCP env. | |
| ICLOUD_USERNAME | Yes | Apple ID. No default. | |
| ICLOUD_SESSION_DIR | No | Directory to store the cookiejar. Overrides default location. | |
| ICLOUD_DOWNLOAD_DIR | No | Local download cache directory. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| statusA | Check whether the Apple ID session is trusted and iCloud Drive is reachable. |
| list_folderA | List one iCloud Drive folder (not recursive). Empty path is the configured root. |
| searchC | Search Drive filenames and paths. Optional ext filter like pdf or .docx. Capped. |
| downloadA | Download Drive files to the local cache directory. Returns local paths, not bytes. |
| read_textA | Download a Drive file if needed and return extracted text (pdf, docx, xlsx, txt). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool maps to a distinct operation: session status, folder listing, filename search, file download, and text extraction. The only possible overlap is download/read_text, but their return types and stated purposes are clearly separated.
Most names follow a simple verb-first style, but status is a noun and search is a bare verb without an object. Still, there is no mixed casing or confusing verb variants, so the pattern remains readable and predictable.
Five tools is well-scoped for a targeted iCloud Drive document access server. There are no redundant or superfluous tools; each one contributes to the core workflow.
The core read-oriented workflow is covered: verify connectivity, navigate folders, search, download, and extract text. Missing write/management operations like upload or delete appear outside this server's stated purpose, though recursive listing or metadata access would be minor enhancements.