Agents: load /llms.txt, then /catalog.json and /commands.json. Open pages from the catalog as needed.
mailkit is a command-line tool that reads and writes mail on this Mac. You (or an agent) run one command per action. Results are tables, or JSON with --json. It is not a mail app, not a server, and not an autopilot. It does not decide what to reply to.

​
What you can do

  • Read the inbox, search, open one message.
  • Draft and reply (these never send).
  • Send only when you confirm.
  • Organize (archive, read/unread, trash; Gmail labels and filters).

​
The send rule

mailkit send will not run without --yes. That flag is the CLI lock. Agents must also show the human the exact To, Subject, and Body and wait for a clear yes for this message. Then, and only then, run mailkit send … --yes. A draft is not permission to send it.

​
Platform

  • macOS only (Keychain for secrets).
  • Three providers: Gmail (full), Fastmail (read-only), Proton Mail (read + send through Bridge). See Providers.

​
Assume install is done

This guide starts when mailkit --version works. If it does not, install first, then return here.

​
Next

  1. Configure accounts if mailkit auth list is empty.
  2. Read mail once an account is authorized.
  3. Agents: For agents.