Homing Pigeon

Homing Pigeon

Homing Pigeon（homingpigeon.dev）は、コードやコーディングエージェントからあなたの携帯電話にテキストメッセージでアラートを送信します。携帯電話会社への登録も、アプリも、ブラウザーでのサインアップも不要です。無料で始められます。

コードやコーディングエージェントからテキストメッセージを受け取りたい場合は、エージェントに次のように伝えてください。

終了したら、Homing Pigeon を使ってテキストメッセージを送ってください。

メッセージは、あなたが確認した米国の携帯電話番号にのみ届きます。「宛先」フィールドはありません。

コーディングエージェントでセットアップする

MCP サーバーを追加すると、エージェントが verify、send、status の3つのツールを利用できるようになります。

# Claude Code
claude mcp add homingpigeondev -- npx -y homingpigeondev mcp

# Claude Code, as a plugin
claude plugin install homingpigeondev --marketplace homingpigeondev/homingpigeondev

# Codex
codex mcp add homingpigeondev -- npx -y homingpigeondev mcp

# Codex, as a plugin with the Homing Pigeon skill
codex plugin marketplace add homingpigeondev/homingpigeondev
codex plugin add homingpigeondev@homingpigeondev

# Gemini CLI
gemini extensions install https://github.com/homingpigeondev/homingpigeondev

Agent Skills を読み込むエージェントは、skills/homingpigeon/SKILL.md を利用できます。

Cursor、Cline、Windsurf など、JSON でセットアップするクライアントでは、MCP 設定ファイル（Cursor の場合は ~/.cursor/mcp.json）に次の内容を追加してください。

{
  "mcpServers": {
    "homingpigeondev": { "command": "npx", "args": ["-y", "homingpigeondev", "mcp"] }
  }
}

エージェントがあなたの電話番号を尋ねるので、届いた6桁のコードを読み上げてください。エージェントがキーをあなたのマシンに保存します。あなたが行うのはコードの入力だけです。

Claude または ChatGPT で使う

この URL をカスタムコネクターとして追加し、電話番号と、テキストメッセージで届く6桁のコードでサインインしてください。

https://homingpigeon.dev/mcp

Claude では、「設定」→「コネクター」→「カスタムコネクターを追加」の順に進みます。ChatGPT では、設定で開発者モードを有効にしてから、アプリとして追加します。「終わったらテキストメッセージを送って」と頼めば、送信されます。テキストメッセージには [Claude] Draft is ready. のように、アプリ名が先頭に付きます。

エージェントの完了時や、あなたの対応が必要なときにテキストメッセージを受け取る

npx -y homingpigeondev verify +15551234567
npx -y homingpigeondev verify +15551234567 123456
npx -y homingpigeondev hook install claude-code   # or codex, cursor

フックを設定しても、プロジェクトには何も変更されません。短いやり取りでテキストメッセージを使いすぎないよう、1回のターンが5分以上続いた場合にのみテキストメッセージが届きます。--after 10 で変更できます。

エージェント	完了時	対応が必要なとき
Claude Code	はい	はい
Codex	はい	はい。まず Codex で /hooks を実行してフックを信頼してください。
Cursor	はい	いいえ。Cursor にはこのイベントがありません。

フックが送信するのはエージェント名とフォルダー名だけで、プロンプトや応答は送信されません。npx -y homingpigeondev hook uninstall claude-code で削除できます。

シェルスクリプトや cron ジョブから使う

npm install -g homingpigeondev

homingpigeon verify +15551234567
homingpigeon verify +15551234567 123456
homingpigeon send "Backtest finished."
./nightly-job.sh || homingpigeon send "Nightly job failed."
tail -1 result.log | homingpigeon send
homingpigeon status

pigeon は短縮形として使えます。機械可読な出力を得るには --json を追加してください。HOMINGPIGEON_API_KEY が設定されている場合は、保存済みのキーの代わりに使用されます。

Python から使う

pip install homingpigeondev

import homingpigeondev

homingpigeondev.send("Backtest finished.")

依存関係はありません。キーは HOMINGPIGEON_API_KEY、または電話番号の確認時に保存されたキーから取得されます。そのため、エージェントや CLI で確認した電話番号もここで使えます。詳細は python/README.md をご覧ください。

あらゆるコードから使う

curl -X POST https://homingpigeon.dev/v1/send \
  -H "Authorization: Bearer $HOMINGPIGEON_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"message": "Backtest finished."}'

homingpigeon key を実行するとキーが表示されます。キーは git に含めないでください。API の全容は llms.txt と homingpigeon.dev/openapi.json に記載されています。

アラートに STOP と返信すると、テキストメッセージが直ちに停止します。再開するには START と返信してください。お問い合わせ先：[email protected]。