Command Line Interface

$

Zoho Mail in your terminal

A fast, script-friendly CLI for Zoho Mail. JSON by default. Pipe to jq. Integrate with your workflows.

$ zoho mail list

[
  {
    "messageId": "1771333290108014300",
    "subject": "Q1 invoice attached",
    "from": "billing@acme.com",
    "date": "1740067200000",
    "unread": true,
    "hasAttachments": true
  },
  {
    "messageId": "1771333290108014301",
    "subject": "Meeting notes",
    "from": "team@company.com",
    "date": "1740063600000",
    "unread": false,
    "hasAttachments": false
  }
]

ID	FROM	SUBJECT	DATE
1771333290108014300	billing@acme.com	Q1 invoice attached	Feb 20
1771333290108014301	team@company.com	Meeting notes	Feb 20

v0.1.1

Features

Everything you need

A complete toolkit for managing Zoho Mail from the command line

JSON by default

Structured output for scripts and automation

Markdown tables

Human-readable format with --md flag

OAuth authentication

Secure browser-based login

Multi-account support

Switch between accounts seamlessly

Folder management

Create, rename, organize programmatically

Script-friendly

Designed for automation workflows

Example

# Filter unread emails
$ zoho mail list | jq -r '.[] | select(.unread) | .subject'

Q1 invoice attached
Meeting notes

Commands

CLI Reference

Explore available commands and their output formats

Output

[
  {
    "messageId": "1771333290108014300",
    "subject": "Q1 invoice attached",
    "from": "billing@acme.com",
    "date": "1740067200000",
    "unread": true
  }
]

ID	FROM	SUBJECT	DATE
1771333290108014300	billing@acme.com	Q1 invoice attached	Feb 20

Global Flags

--account
Specify account

--md
Markdown output

--debug
Debug logs

--config
Config path

Setup

Get connected

Three steps to connect your Zoho Mail account. Region auto-detected.

Create OAuth client

Go to Zoho API Console and create a Mobile/Desktop Application client.

Visit api-console.zoho.com ↗
Click "Add Client" → "Mobile/Desktop"
Set name: zoho-cli
Add redirect: http://localhost:51821/callback

Save credentials

Run the config command and enter your Client ID and Secret.

Run: zoho config init
Enter Client ID
Enter Client Secret
Config saved to ~/.config/zoho-cli/

Authenticate

Run: zoho login
Browser opens automatically
Approve access in Zoho
Tokens stored in OS keyring

Supported Regions

Auto-detects your Zoho data center. No configuration needed.

zoho.com zoho.eu zoho.in zoho.com.au zoho.jp zoho.ca

Tip: For CI/headless, use zoho login --no-browser

$