Fastmail

fm CLIを使用してFastmailを管理します。このCLIはFastmailのJMAP APIと通信します。すべてのコマンドは機械可読出力用の --json をサポートしています。

前提条件

fm がインストールされ、認証されていることを確認してください:

fm --version    # インストール確認
fm auth status  # 認証確認

認証されていない場合は、fm auth login を実行し、https://app.fastmail.com/settings/security/tokens からFastmail APIトークンを入力してください。

コマンドリファレンス

fm describe でJSON形式の完全なコマンドツリーを取得します。詳細なフラグドキュメントは fm <command> --help を使用してください。

認証

fm auth login     # APIトークンの入力を促し、キーリングに保存
fm auth status    # 認証済みユーザーとアカウントIDを表示
fm auth logout    # 保存されたトークンを削除

メール操作

# リストと検索
fm inbox                                    # 最新の受信箱メール20件
fm email list --mailbox=Archive --limit=50  # 特定のメールボックスからリスト
fm email search "query" --from=addr --after=2026-01-01

# 読み取り
fm email read <id>              # テスト本文(ページャーを通す)
fm email read <id> --html       # HTML本文
fm email read <id> --headers    # すべてのヘッダー

# スレッド
fm email thread <id>            # 完全なスレッド会話

# 送信
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>"

# 返信と転送
fm email reply <id> --body="Thanks!"
fm email reply <id> --all           # すべての受信者に返信
fm email forward <id> --to=addr

# 整理
fm email move <id> Archive
fm email delete <id>                # ゴミ箱に移動
fm email delete <id> --permanent    # 完全に削除
fm email flag <id>                  # スター/フラグ
fm email unflag <id>
fm email mark-read <id>
fm email mark-unread <id>

# 添付ファイル
fm email attachment <email-id>              # すべてダウンロード
fm email attachment <email-id> <blob-id>    # 特定のファイルをダウンロード
fm email attachment <email-id> -o ./dir/    # 出力ディレクトリ

メールボックス

fm mailbox list                         # 未読/合計数付きでリスト表示
fm mailbox create "Name"
fm mailbox rename "OldName" "NewName"
fm mailbox delete "Name"
fm mailbox delete "Name" --force        # すべてのメールと共に削除

マスクメール

Fastmailのマスクメール機能は使い捨てアドレスを作成します。

fm masked-email list
fm masked-email list --state=enabled    # フィルター: enabled/disabled/pending/deleted
fm masked-email create --domain=example.com --description="Signup"
fm masked-email create --prefix=myprefix --domain=shop.com
fm masked-email enable <id>
fm masked-email disable <id>
fm masked-email delete <id>

アイデンティティ

fm identity list    # 送信アイデンティティを表示(名前、メール、ID)

Sieveフィルター

fm sieve list                              # アクティブ状態付きでスクリプトをリスト
fm sieve get <id>                          # スクリプト内容を表示
fm sieve set "name" filter.sieve           # ファイルからアップロード
echo 'keep;' | fm sieve set "keep-all"     # 標準入力からアップロード
fm sieve activate <id>
fm sieve deactivate
fm sieve delete <id>
fm sieve validate filter.sieve             # 構文をチェック(保存せず)

休暇自動返信

fm vacation get
fm vacation set --subject="Out of office" --body="Back on Monday"
fm vacation set --from=2026-04-01 --to=2026-04-15
fm vacation disable

設定

fm config init    # デフォルト ~/.config/fm/config.toml を作成
fm config show    # 現在の設定を表示
fm config path    # 設定ファイルのパスを表示

エージェントイントロスペクション

fm describe       # JSON形式の完全なコマンドツリー

JSON出力の操作

すべてのコマンドは、パイプとスクリプト処理に適した構造化出力の --json をサポートします:

# 受信箱をJSONで取得
fm inbox --json

# jqでメールIDを抽出
fm email list --json | jq -r '.[].id'

# マスクメールアドレスを取得
fm masked-email list --json | jq -r '.[].email'

# メールボックス名と未読数を取得
fm mailbox list --json | jq '.[] | {name, unreadEmails}'

注意点

• fm email search には最低1つの位置引数クエリが必要です。フラグのみでは動作しません。フラグのみを使う場合は、空のクエリとして "" を渡してください。
• fm email read は標準出力がターミナルの場合、$PAGER (または less) を通してパイプします。ページャーをスキップするには --json を使用するか、別のコマンドへパイプしてください。
• マスクメールの delete は状態を deleted に設定します(メールをバウンス)。レコードは削除されません。deleted からは取り消しできません。
• Sieveスクリプトは削除前に非アクティブ化する必要があります。fm sieve delete はアクティブなスクリプトで失敗します。
• --mailbox フラグはメールボックス名とIDの両方を受け入れます。名前は大文字と小文字を区別して照合されます。
• トークン解決順序: --token フラグ > FASTMAIL_API_TOKEN 環境変数 > OSキーリング。
• キーリングのないヘッドレスサーバーでは、FASTMAIL_API_TOKEN 環境変数を使用してください。

Fastmail JMAPの詳細

高度な使用方法またはデバッグについては、references/jmap.md を参照してください。