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