jottacloud-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| JOTTACLOUD_MOUNT | No | Jottacloud mount name. Defaults to Archive. | Archive |
| JOTTACLOUD_ROOTS | No | Allowed path prefixes (default /Archive). | /Archive |
| JOTTACLOUD_DEVICE | No | Jottacloud device name. Defaults to Jotta. | Jotta |
| JOTTACLOUD_LIVE_TEST | No | 1 enables live API tests (not used in CI). | 0 |
| JOTTACLOUD_READ_ONLY | No | 1 (default) omits write tools; 0 enables them. | 1 |
| JOTTACLOUD_LOGIN_TOKEN | No | One-shot personal login token used for bootstrap. Optional after a successful token exchange. | |
| JOTTACLOUD_TOKEN_STORE | No | Override token file path. Defaults to ~/.config/jottacloud-mcp/tokens.json. |
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": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| loginA | Sign in with a Jottacloud personal login token. The host should prompt privately (elicitation). Do not paste the token into chat. |
| list_rootsA | List configured Jottacloud path roots this server may access, plus discovered mounts when logged in. Trash is not a default search root. |
| list_directoryC | List files and folders at a Jottacloud path (e.g. /Archive or /Archive/docs). |
| get_file_infoA | Get metadata for a Jottacloud file or folder. Does not download content. |
| search_filesB | Search file and folder names under a path. Uses Jottacloud liststream when possible, then a capped folder walk. |
| read_fileA | Read a file from Jottacloud. Text is returned as UTF-8 (capped); binary as base64. Use head/tail/max_bytes to stay small. |
| list_trashA | List items in Jottacloud trash (~30 days). Trash is not included in default roots or search. |
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 7 tools
Each tool has a clearly distinct purpose: authentication, listing roots, listing directory contents, metadata retrieval, searching, reading file content, and trash listing. No overlap or ambiguity between tools.
All tool names follow a consistent verb_noun pattern in snake_case (list_roots, get_file_info, search_files, etc.). Naming is predictable and uniform across the set.
Seven tools is well-scoped for a cloud storage MCP. Each tool serves a distinct function without redundancy or missing essentials, fitting comfortably in the ideal range.
The read-focused surface covers listing, searching, metadata, and file reading, plus trash handling. Write operations (upload, delete, move) are absent, but if the server is intended for read-only access, only minor gaps remain (e.g., no way to download complete files without streaming limits).