haru Mail CLI

日本のAI開発者のためのメール送受信API haru Mail の公式CLI。 依存ゼロ（Node 18+ の標準機能だけで動作）・インストール不要（npx で即実行できます）。

Official CLI for haru Mail — the email sending & receiving API for developers in Japan. Zero dependencies.

使い方

# APIキーを保存（キーはダッシュボードまたはオンボーディングで発行されます）
npx harumail login hm_xxxxx

# 送信
npx harumail send --to [email protected] --subject "件名" --text "本文"

# 本文をパイプで渡す（cron・CI/CDの通知に）
./backup.sh && date | npx harumail send --to [email protected] --subject "バックアップ完了" --text -

コマンド一覧

| コマンド | 説明 | |---|---| | harumail login hm_xxxxx | APIキーを ~/.config/harumail/config.json に保存 | | harumail send --to … --subject … --text … | メール送信（--html / --cc / --bcc / --reply-to / --from 対応。--text - でstdin） | | harumail logs [件数] | 送信履歴（送信箱・既定20件） | | harumail inbound [件数] | 受信メール一覧（受信箱・既定20件） | | harumail read em_xxx \| in_xxx | 送信・受信どちらのメールも読みやすく表示 | | harumail get em_xxx | 送信メールの生データ（JSON） | | harumail domains | 差出人に使えるドメイン一覧 | | harumail usage | 今月の使用量（アップグレードURL付き） | | harumail upgrade | プランと料金のページをブラウザで開く |

--from を省略すると、登録ドメイン1つ目の info@ が使われます。

環境変数

設定ファイルより優先されます。CI/CDではこちらを使ってください。

HARUMAIL_API_KEY=hm_xxxxx      # APIキー
HARUMAIL_BASE_URL=https://...  # 通常は変更不要

ドキュメント

• 全機能のリファレンス: https://harumail.app/docs/
• AIに組み込ませる場合: https://harumail.app/docs/llms-full.txt をAIに渡すだけで統合できます

ライセンス

MIT © 株式会社Web春