iCloud Mail, from the command line
Your inbox.
In your shell.
Search, read, draft, send, and organize iCloud Mail without leaving your terminal. Compact for humans, predictable for scripts, and easy for agents to use.
npm install -g @amxv/icloud-cli01 / Mail, end to end
Everything you need to work through your mailbox.
Sync new mail, search across messages and attachments, read complete conversations, compose drafts, reply and forward, manage folders, and save files — all through one consistent icloud mail command tree.
02 / Everyday workflows
From a crowded inbox
to the next action.
Read
Sync your mailbox, open complete messages, browse conversations, save attachments
Search
Find mail locally in an instant or query iCloud directly when freshness matters
Compose
Draft, send, reply, reply-all, forward, use aliases, signatures, and S/MIME
Organize
Move, archive, flag, trash, manage folders, and apply reviewed bulk actions
03 / Built for agents
Small outputs. Stable IDs. Deliberate writes.
Routine commands stay compact. JSON and JSONL are there when you need structure. Stable message and thread IDs, dry-run previews, and idempotent writes make multi-step mail workflows dependable in scripts and agents.
Read the agent guide{
"to": ["client@example.com"],
"subject": "Project update",
"body_file": "message.txt",
"idempotency_key": "update-01"
}04 / Documentation
Start with a command.
Go deeper when you need to.
Start here when you know you want to work with Mail but are not sure which command or guide covers the task.
Quickstart
The shortest useful path through account setup, sync, reading, search, and safe sending.
Search mail
Search locally by default, add useful filters, and opt into remote search only when you need a fresh provider check.
Send, reply, and forward
Everyday outbound Mail: preview first, send deliberately, and avoid accidental duplicate sends.
Organize mail
Familiar mailbox actions with dry-run previews for location-changing operations.
Agent guide
The conventions an agent should follow to use the CLI accurately, safely, and with minimal output.
Your mailbox, from anywhere you have a shell.