fastmaillisted
Install: claude install-skill vicyap/fastmail-cli
# Fastmail
Manage Fastmail via the `fm` CLI, which talks to Fastmail's JMAP API. All commands support `--json` for machine-readable output.
## Prerequisites
Ensure `fm` is installed and authenticated:
```bash
fm --version # Verify installation
fm auth status # Verify authentication
```
If not authenticated, run `fm auth login` and provide a Fastmail API token from https://app.fastmail.com/settings/security/tokens
## Command Reference
Use `fm describe` to get the full command tree as JSON. Use `fm <command> --help` for detailed flag documentation.
### Authentication
```bash
fm auth login # Prompt for API token, store in keyring
fm auth status # Show authenticated user and account ID
fm auth logout # Remove stored token
```
### Email Operations
```bash
# List and search
fm inbox # 20 most recent inbox emails
fm email list --mailbox=Archive --limit=50 # List from specific mailbox
fm email search "query" --from=addr --after=2026-01-01
# Read
fm email read <id> # Text body (piped through pager)
fm email read <id> --html # HTML body
fm email read <id> --headers # All headers
# Thread
fm email thread <id> # Full thread conversation
# Send
fm email send --to=addr --subject="Subject" --body="Body"
fm email send --to=addr --subject="Subject" < body.txt
fm email send --to=addr --subject="Subject" --attach=file.pdf
fm email send --to=addr --subject="Subject" --html --body="<h1>Hi</h1>"
# Rep