Homing Pigeon

Homing Pigeon

Homing Pigeon（homingpigeon.dev）可从你的代码或编码 Agent 向一部手机发送短信提醒：你的手机。无需运营商注册、无需应用，也无需在浏览器中注册。免费开始使用。

如果你希望代码或编码 Agent 给你发短信，请告诉你的 Agent：

使用 Homing Pigeon，在任务完成时给我发短信。

消息只会发送到你验证过的美国手机号码。没有“收件人”字段。

与编码 Agent 配合设置

添加 MCP 服务后，Agent 就能使用三个工具：verify、send 和 status。

# 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 的 Agent 可以使用 skills/homingpigeon/SKILL.md。

对于通过 JSON 配置的 Cursor、Cline、Windsurf 和其他客户端，请将以下内容添加到它们的 MCP 设置文件中（对于 Cursor，文件为 ~/.cursor/mcp.json）：

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

Agent 会询问你的号码，你读出收到的六位验证码，Agent 随后会将密钥保存在你的设备上。你只需完成验证码这一步。

在 Claude 或 ChatGPT 中使用

将此 URL 添加为自定义连接器，然后使用你的手机号码和收到的六位验证码登录：

https://homingpigeon.dev/mcp

在 Claude 中，依次选择 Settings → Connectors → Add custom connector。在 ChatGPT 中，先在设置中开启开发者模式，再将其添加为应用。你可以说“完成后给我发短信”，它就会照做。短信会以应用名称开头，例如 [Claude] 草稿已准备好。

在 Agent 完成任务或需要你时收到短信

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

钩子不会更改项目中的任何内容。为避免在快速回复上浪费短信，只有当一轮运行至少 5 分钟时，才会向你发送短信。使用 --after 10 可更改此设置。

Agent	完成任务	等待你
Claude Code	是	是
Codex	是	是。请先在 Codex 中运行 /hooks，信任这些钩子。
Cursor	是	否。Cursor 没有对应的事件。

钩子会发送 Agent 名称和文件夹名称，绝不会发送你的提示词或 Agent 的回复。运行 npx -y homingpigeondev hook uninstall claude-code 可将其移除。

在 Shell 脚本或 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 环境变量或你验证时保存的密钥中查找密钥，因此，通过 Agent 或 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]。