communication
Zoho Mail CLI for Headless Automation
Use the Zoho Mail CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
6 functions 5 read 1 write Manual OAuth token auth
Zoho Mail CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Zoho Mail CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Zoho Mail CLI for Headless Automation
kosmokrator integrations:configure zoho-mail --set access_token="$ZOHO_MAIL_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call zoho-mail.zohomail_list_messages '{"accountId":"example_accountId","folderId":"example_folderId","start":1,"limit":1,"searchKey":"example_searchKey"}' --json Discovery Before Execution
Agents and scripts can inspect Zoho Mail docs and schemas before choosing a function.
kosmo integrations:docs zoho-mail --json
kosmo integrations:docs zoho-mail.zohomail_list_messages --json
kosmo integrations:schema zoho-mail.zohomail_list_messages --json
kosmo integrations:search "Zoho Mail" --json
kosmo integrations:list --json Useful Zoho Mail CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
zoho-mail.zohomail_list_messages | Read | accountId, folderId, start, limit, searchKey | List email messages in a Zoho Mail folder. Returns message summaries including sender, subject, and date. |
zoho-mail.zohomail_get_message | Read | accountId, messageId | Get a single email message from Zoho Mail by ID. Returns full message content, headers, and attachment info. |
zoho-mail.zohomail_send_message | Write | accountId, toAddress, subject, content, ccAddress, bccAddress, inReplyTo, mailFormat | Send a new email message via Zoho Mail. Supports to, cc, bcc, subject, and HTML or plain text content. |
zoho-mail.zohomail_list_folders | Read | accountId | List all email folders in a Zoho Mail account, including Inbox, Sent, Drafts, Trash, and custom folders. |
zoho-mail.zohomail_list_tasks | Read | accountId, start, limit | List tasks from Zoho Mail. Returns task details including title, status, due date, and priority. |
zoho-mail.zohomail_get_current_user | Read | none | Get the current user's Zoho Mail account information. Returns account IDs needed for other Zoho Mail operations. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.