fastmail-cli

Read-only email access for AI agents via JMAP, and draft responses.

---

Demo

---

Installation

uv add fastmail-cli

Or run without installing:

uvx fastmail-cli help

Setup

export FASTMAIL_API_TOKEN="fmu1-..."# from Fastmail Settings → Integrations

Usage

# Read
fastmail-cli email.query --limit 5 # recent emails
fastmail-cli email.query --filter '{"from":"alice"}'# search
fastmail-cli email.get --ids '["M123"]'# full email by ID
fastmail-cli mailbox.query # list mailboxes
fastmail-cli thread.get --ids '["T456"]'# get thread# Draft (safe for AI agents - human reviews before sending)
fastmail-cli email.draft --to "bob@x.com" --subject "Hi" --body "..."
fastmail-cli email.draft-reply --id "M123" --body "Thanks!"
fastmail-cli email.draft-reply --id "M123" --body @reply.txt --reply-all
# Advanced
fastmail-cli email.changes --since-state "abc123"# poll for changes
fastmail-cli searchsnippet.get --email-ids '["M1"]' --filter '{"text":"foo"}'
fastmail-cli describe email.query # show command options

All output is JSON with ok, command, meta, and data/error fields.

Required Reading

• Getting Claude Code to do my emails
• jmap-mcp

License

Apache 2.0