Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Developer Tools
Zoho Mail CLI
Read, search, send, and manage Zoho Mail from the terminal. JSON output for scripting and agents. No third-party service required.
skill openclawclawhub Free
Read, search, send, and manage Zoho Mail from the terminal. JSON output for scripting and agents. No third-party service required.
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 0.1.4
Provenance
- Publisher
- robsannaa
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
zoho โ Zoho Mail CLI
Requirements: the zoho binary (install via brew/uv/pipx below), one-time OAuth setup, and local credential storage (config + OS keyring). zoho is a command-line tool for Zoho Mail. All output is JSON by default โ structured, pipe-friendly, and agent-ready. Use --md for markdown tables.
Install
Requires Python 3.11+. Works on macOS, Linux, and Windows. # Homebrew (macOS / Linux) brew install robsannaa/tap/zoho-cli # uv (all platforms) uv tool install git+https://github.com/robsannaa/zoho-cli # pipx (all platforms) pipx install git+https://github.com/robsannaa/zoho-cli After install, run the one-time setup: zoho config init # save your Zoho OAuth client_id / client_secret zoho login # open browser, region auto-detected See the full setup guide in the README.
Prerequisites
zoho must be installed and authenticated (zoho login completed). Check: zoho config show โ must return a JSON object with default_account and a non-empty accounts map. If not logged in: tell the user to follow the setup in the README.
Output
stdout โ JSON (default) or Markdown (--md). Always machine-readable. stderr โ errors (as JSON), debug logs, interactive prompts. Never in stdout. Exit 0 = success. Exit 1 = error (JSON error object on stderr). # errors land on stderr, not stdout zoho mail list 2>/dev/null # stdout empty on error zoho mail list 2>&1 >/dev/null # see error JSON
Authentication
Tokens are stored in the OS keyring and refreshed automatically before every command. No manual token management needed. Credential storage (sensitive): Users must be aware that the CLI stores sensitive data locally: OAuth client_id and client_secret โ saved via zoho config init in the config file (e.g. ~/.config/zoho-cli/config.json). Access and refresh tokens โ stored in the OS keyring (or, if ZOHO_TOKEN_PASSWORD is set, in an encrypted file). These are used to access Zoho Mail on the user's behalf. Do not expose config files or keyring entries to untrusted parties. If a command fails with not_logged_in or token_refresh_failed, tell the user to run: zoho login
Global flags
--account EMAIL select account (env: ZOHO_ACCOUNT) --config PATH config file path (env: ZOHO_CONFIG) --md markdown table output instead of JSON --debug HTTP + debug logs to stderr
zoho mail list
List messages in a folder. zoho mail list # Inbox, 50 messages zoho mail list --folder Sent --limit 20 zoho mail list -f "My Project" -n 100 Output โ array of message summaries: [ { "messageId": "1771333290108014300", "folderId": "8072279000000002014", "subject": "Q1 invoice", "from": "billing@acme.com", "to": ["you@example.com"], "date": "1740067200000", "unread": true, "hasAttachments": true, "tags": [] } ] date is a Unix timestamp in milliseconds.
zoho mail search
zoho mail search "invoice 2025" zoho mail search "from:boss@example.com" --limit 10 Same output shape as mail list.
zoho mail get
Full message content including body. zoho mail get MESSAGE_ID zoho mail get MESSAGE_ID --folder-id FOLDER_ID # faster: skips auto-scan zoho mail get MESSAGE_ID | jq '.textBody' Output: { "messageId": "...", "folderId": "...", "subject": "Q1 invoice", "from": "billing@acme.com", "to": ["you@example.com"], "cc": [], "bcc": [], "date": "1740067200000", "unread": false, "hasAttachments": true, "tags": [], "textBody": "Please find the invoice attached.", "htmlBody": "<p>Please find...</p>" }
zoho mail attachments
zoho mail attachments MESSAGE_ID zoho mail attachments MESSAGE_ID --folder-id FOLDER_ID Output: [ { "attachmentId": "256063600000020001", "fileName": "invoice.pdf", "size": 123456 } ]
zoho mail download-attachment
zoho mail download-attachment MESSAGE_ID ATTACHMENT_ID --out /tmp/invoice.pdf Output: { "status": "ok", "path": "/tmp/invoice.pdf", "size": 123456 }
zoho mail send
zoho mail send --to alice@example.com --subject "Hi" --text "Hello!" # HTML + multiple recipients + attachments zoho mail send \ --to alice@example.com --to bob@example.com \ --cc manager@example.com \ --subject "Report" \ --html-file report.html \ --attach report.pdf --attach data.csv Output: { "status": "ok", "messageId": "..." }
Flag / move / delete operations
All accept one or more MESSAGE_ID arguments. zoho mail mark-read ID [ID โฆ] zoho mail mark-unread ID [ID โฆ] zoho mail move ID [ID โฆ] --to "Archive" zoho mail spam ID [ID โฆ] zoho mail not-spam ID [ID โฆ] zoho mail archive ID [ID โฆ] zoho mail unarchive ID [ID โฆ] zoho mail delete ID [ID โฆ] # โ Trash zoho mail delete ID [ID โฆ] --permanent # hard delete Output: { "status": "ok", "updated": ["ID1", "ID2"], "failed": [] }
zoho folders list
zoho folders list Output: [ { "folderId": "8072279000000002014", "folderName": "Inbox", "folderType": "Inbox", "path": "/Inbox", "isArchived": 0, "unreadCount": 3, "messageCount": 42 } ]
zoho folders create / rename / delete
zoho folders create "Project X" [--parent-id FOLDER_ID] zoho folders rename FOLDER_ID "New Name" zoho folders delete FOLDER_ID
zoho config show / path / init
zoho config show # JSON config dump (secret redacted) zoho config path # {"config_path": "...", "exists": true} zoho config init # interactive wizard (prompts on stderr)
Common patterns for agents
# All unread message subjects zoho mail list | jq -r '.[] | select(.unread) | .subject' # Get the latest message ID zoho mail list -n 1 | jq -r '.[0].messageId' # Get plain-text body of a specific message zoho mail get "$MSG_ID" | jq -r '.textBody' # Download all attachments from a message zoho mail attachments "$MSG_ID" | jq -r '.[].attachmentId' | while read id; do zoho mail download-attachment "$MSG_ID" "$id" --out "/tmp/${id}" done # Find unread emails from a sender zoho mail search "from:boss@example.com" | jq '[.[] | select(.unread)]' # Mark all results as read zoho mail search "invoice" | jq -r '.[].messageId' | xargs zoho mail mark-read # Move search results to a folder zoho mail search "newsletter" | jq -r '.[].messageId' | xargs zoho mail move --to "Archive" # Send with computed body zoho mail send \ --to report-reader@example.com \ --subject "Daily digest $(date +%F)" \ --text "$(zoho mail list | jq -r '.[].subject' | head -10 | nl)"
Error response shape
All errors are JSON on stderr: { "status": "error", "error": "not_logged_in", "details": "No stored token for you@example.com. Run: zoho login --account you@example.com" } Common error codes: CodeMeaningnot_logged_inNo token stored โ user must run zoho logintoken_refresh_failedToken revoked โ user must run zoho loginno_account_idaccountId not saved โ run zoho login againfolder_not_foundFolder name doesn't match any foldermessage_not_foundMessage ID not found in any folderapi_errorUpstream Zoho API error (details in message)
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs
- SKILL.md