A robust command-line interface for Zoho Mail that outputs machine-readable JSON for seamless automation and agent workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install zoho-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install zoho-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Zoho Mail CLI?
This skill provides a full-featured interface for interacting with Zoho Mail directly from your terminal. Built with Python 3.11+, it allows users to perform complex email operations like listing messages, searching with filters, and sending attachments without leaving the command line. As part of the Openclaw Skills ecosystem, it is designed to be pipe-friendly and agent-ready, providing structured JSON output by default.
The tool prioritizes security by utilizing the OS keyring for token storage and local configuration files for OAuth credentials. Whether you are building custom notification scripts or integrating email capabilities into an AI agent, this skill offers the flexibility and reliability needed for modern developer workflows. Its compatibility with various platforms and installation methods makes it a versatile addition to any Openclaw Skills setup.
Zoho Mail CLI Use Cases
- Automating daily email digests and reporting using Openclaw Skills scripts.
- Searching and processing invoices or receipts directly via the CLI for accounting automation.
- Integrating Zoho Mail functionality into custom AI agent workflows to enable autonomous communication.
- Managing folders and archiving old emails through automated shell scripts.
- Downloading email attachments programmatically for data processing pipelines.
How Zoho Mail CLI Works
- The user installs the zoho binary via Homebrew, uv, or pipx on their local machine.
- A one-time OAuth configuration is performed using the init and login commands to authorize access.
- The CLI interacts with the Zoho Mail API using secure tokens stored in the OS keyring or an encrypted file.
- Commands generate structured JSON output that can be piped into tools like jq or processed directly by Openclaw Skills agents.
- OAuth tokens are automatically refreshed before every command execution to ensure continuous, uninterrupted access.
Zoho Mail CLI Setup
First, ensure you have Python 3.11+ installed. You can install the CLI using one of the following methods:
# 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 installation, initialize your credentials and log in:
zoho config init # Enter your Zoho OAuth client_id / client_secret
zoho login # Follow the browser prompt to authenticate
Zoho Mail CLI Data Schema & Taxonomy
The skill organizes data into structured JSON formats to ensure compatibility with Openclaw Skills workflows:
| Object Type | Key Fields |
|---|---|
| Message | messageId, folderId, subject, from, to, date (ms), unread, hasAttachments, tags |
| Folder | folderId, folderName, folderType, path, unreadCount, messageCount |
| Attachment | attachmentId, fileName, size |
| Config | default_account, accounts map (stored in config.json) |
| Status | status (ok/error), updated/failed IDs, messageId |
All errors are returned as JSON on stderr with specific error codes like not_logged_in or api_error for programmatic handling.
Zoho Mail CLI Advanced Features
- Native JSON output for seamless integration with Openclaw Skills and external tools like jq.
- Support for HTML email bodies and multiple file attachments in a single send command.
- Multi-account management using the --account flag or ZOHO_ACCOUNT environment variable.
- Headless and CI/CD support via encrypted file token storage using the ZOHO_TOKEN_PASSWORD passphrase.
- Markdown table output option for high-quality human-readable terminal displays.
- Automatic region detection and token refresh logic to minimize manual intervention.
SKILL.md
Loading
Related Openclaw Skills
pm-sim
A high-fidelity simulation and paper trading environment for Polymarket prediction markets featuring 26 specialized MCP tools.
Duplicati Manager
A powerful interface to manage and automate Duplicati backup operations using secure Bearer tokens and REST API integration.
WeChat Moments 4-Grid Card Generator
Automatically transforms any topic into a complete WeChat Moments post featuring engaging copy and four professionally styled tutorial cards.
Watch.dog Uptime Monitor
A powerful monitoring integration that enables AI agents to track website uptime, API health, and cron job status using the Watch.dog platform.
agent-self-care
A specialized maintenance skill that automates health monitoring, process cleanup, and performance optimization for autonomous agents.
Cashu Emoji
A specialized tool for embedding and extracting Cashu tokens or hidden messages within standard emojis using Unicode variation selectors.
Featured*
