communication
Zoho Mail CLI for Shell Scripts
Use the Zoho Mail CLI for shell scripts with headless JSON commands, schema discovery, credentials, and permission controls.
6 functions 5 read 1 write Manual OAuth token auth
Zoho Mail CLI for Shell Scripts
Call integration functions from shell scripts with stable JSON input and output.
Use shell scripts for small local automations that need one or more integration calls. 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 Shell Scripts
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.