| name | fastmail |
| description | Fastmail email, masked emails, calendar, contacts, and vacation management |
Fastmail Skill
Manage Fastmail email, masked email aliases, calendars, contacts, and vacation auto-reply via the fastmail CLI.
Prerequisites
fastmail CLI installed and authenticated (fastmail auth)
FASTMAIL_ACCOUNT environment variable set to your account email
Commands
Email Operations
fastmail --output=json email list --limit 10
fastmail --output=json email search "invoice" --limit 20
fastmail --output=json email get <emailId>
fastmail email send --to user@example.com --subject "Hello" --body "Message"
fastmail email send --to user@example.com --subject "Report" --body "See attached" --attach report.pdf
fastmail --output=json email mailboxes
Masked Email (Aliases)
Create disposable email aliases that forward to your inbox.
fastmail --output=json masked create example.com "Shopping account"
fastmail --output=json masked list
fastmail --output=json masked list example.com
fastmail masked enable user.1234@fastmail.com
fastmail masked disable user.1234@fastmail.com
fastmail masked delete user.1234@fastmail.com
Calendar
fastmail --output=json calendar list
fastmail --output=json calendar events
fastmail calendar event-create --title "Meeting" --start "2024-01-15T10:00:00" --end "2024-01-15T11:00:00"
fastmail calendar invite --title "Team Sync" --start "2024-01-15T14:00:00" --attendees alice@example.com,bob@example.com
Contacts
fastmail --output=json contacts list
fastmail --output=json contacts search "john"
fastmail contacts create --name "John Doe" --email john@example.com
Vacation / Auto-Reply
fastmail --output=json vacation get
fastmail vacation set --subject "Out of Office" --body "I'm away until Jan 20"
fastmail vacation disable
Output
Use --output=json for structured output. Use --query to apply jq filters:
fastmail --output=json --query '.[] | select(.unreadEmails > 0)' email mailboxes
Common Options
| Flag | Description |
|---|
--account | Override account email |
--limit | Limit results (for list/search operations) |
--output | Output format: text or json |
--query | JQ filter expression for JSON output |