# Send Zoho  Mail CLI to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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

```text
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.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "zoho-cli",
    "name": "Zoho  Mail CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/robsannaa/zoho-cli",
    "canonicalUrl": "https://clawhub.ai/robsannaa/zoho-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/zoho-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zoho-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "zoho-cli",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-11T13:28:46.243Z",
      "expiresAt": "2026-05-18T13:28:46.243Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zoho-cli",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zoho-cli",
        "contentDisposition": "attachment; filename=\"zoho-cli-0.1.4.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "zoho-cli"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/zoho-cli"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/zoho-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/zoho-cli",
    "agentUrl": "https://openagent3.xyz/skills/zoho-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/zoho-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/zoho-cli/agent.md"
  }
}
```
## 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)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: robsannaa
- Version: 0.1.4
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-11T13:28:46.243Z
- Expires at: 2026-05-18T13:28:46.243Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/zoho-cli)
- [Send to Agent page](https://openagent3.xyz/skills/zoho-cli/agent)
- [JSON manifest](https://openagent3.xyz/skills/zoho-cli/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/zoho-cli/agent.md)
- [Download page](https://openagent3.xyz/downloads/zoho-cli)