SkillFoxx

zele CLI

zele reads and writes Gmail, Outlook and IMAP mail, manages Google Calendar and returns YAML results for agents.

  • 302 ★ on the repository
  • Last commit
CLI

Broad access

Why this level

  • An agent gets reading and sending mail and calendar access on personal accounts, and tokens are stored on your machine.
All reasons and checks

remorses/zeleAuthor:Tommaso De Rossi

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add cli/zele

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • An agent gets reading and sending mail and calendar access on personal accounts, and tokens are stored on your machine.

This is third-party code. Review the repository files before installing.

What it does

zele is a command-line mail and calendar client for you and your agents. It handles several accounts at once: Google through OAuth, Microsoft (Outlook, Hotmail) through OAuth, any IMAP/SMTP provider such as Fastmail, and free `@zele.sh` addresses. Data is cached in SQLite and output is YAML. Mail: `zele mail list`, `search` with Gmail syntax, `read`, `send`, `reply`, `forward`, flags, archive and attachments. There are drafts and, for Google, labels and filters. Google Calendar: `zele cal events`, `create`, `update`, `respond` and `freebusy`. The `zele mail watch` mode waits for a message by filter, for example one with a confirmation code. For agents, login in a shell without a terminal starts a background process and returns a confirmation URL at once. The free `@zele.sh` inboxes are made for agents: up to ten permanent addresses, receive-only for now.

Who it is for. Developers and anyone who hands an agent mail triage and scheduling and wants to do it from the terminal across several mailboxes.

Good fit when

  • An agent triages unread mail from several accounts in one list.
  • A script waits for a confirmation-code email with `zele mail watch`.
  • A separate `@zele.sh` inbox is created for an agent so it gets no access to personal mail.
  • A reply is prepared with `zele mail reply --dry-run` to check the recipient.

Not a fit when

  • You need a shared client with no mail access: an agent with `zele` can send emails.
  • You need labels, filters or a calendar on an IMAP account: they are Google-only.
  • A `@zele.sh` inbox must send mail: for now it only receives.

Example request

Show unread mail from all my mailboxes for today and prepare reply drafts without sending them.

Limitations

CLI commands need Node.js 22.16 or newer, and the interactive interface also needs Bun. Labels, filters and calendar work only with Google. Microsoft login uses Thunderbird's public client ID, which matters under corporate policies. An agent with access can read and send mail, and tokens are stored on your machine. The `@zele.sh` inboxes only receive mail, and the owner can only be a Gmail address. The repository metadata states no licence. The last commit dates from November 2026.

How to disable. Sign out with `zele logout` and uninstall the package, for example `npm uninstall -g zele`. `@zele.sh` inboxes are deleted with `zele inbox delete`, and the address is never reissued.

FAQ

How do I install zele?

With `npm install -g zele` for the CLI. The full interface with the TUI needs Bun: `bun install -g zele`.

How do I log in from an agent with no terminal?

Run `zele login --method google` or `zele login microsoft`: a background process starts, open the printed URL and approve access, then check `zele whoami`.

How do I check a reply's recipient?

Add `--dry-run` to `zele mail reply <thread-id>`: the command shows who the reply goes to. The recipient can be set with `--to`.

How do I connect Fastmail or Proton Mail?

Through `zele login imap` with the address, IMAP and SMTP servers and an app password. Proton Mail Bridge has `--no-tls` and `--ca` flags for the certificate.

What are zele.sh inboxes?

Free permanent addresses for you, a project or an agent, up to ten. For now they only receive mail and are created with `zele login zele --owner you@gmail.com --name name`.

Discussion

No questions or reviews yet.

CLI tools

Nylas CLI runs Google, Microsoft and IMAP mail, calendar and contacts from the terminal and through an MCP server for agents.

CLIBroad access83
Russian stack

An MCP server and OpenClaw plugin for Yandex Mail, Calendar, Disk and Contacts using app passwords

MCP serverBroad access1
Russian stack

A skill for reading and searching email over IMAP via the myl CLI: Gmail, Yandex Mail, Mail.ru, autodiscovery for others

SkillMinimal access2

An email MCP with 52 tools: the agent reads, searches, sends and sorts mail across several accounts over IMAP and SMTP, and schedules sends

MCP serverBroad access158
Official

A terminal CLI and TUI for HEY mail, calendar and contacts, used by a person or by an agent

CLIBroad access426

GSuite MCP

mcp-gsuite

A Python MCP server for Gmail and Google Calendar: search and read emails, drafts and replies, events with attendees, several accounts at once

MCP serverBroad access491

README in short

A single interface for mail and calendar: several accounts merge into one list, and features IMAP lacks return a clear error.

README badge

Report a problem