Skip to main content
MCP server CX Codex

Homing Pigeon — Claude Code MCP server: alerts and setup

The Homing Pigeon MCP server for Claude Code sends text alerts to a verified phone. An agent can notify you when a task ends or when it needs a response.

MIT updated 2026-11-16

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http homingpigeondev https://homingpigeon.dev/mcp
Open on GitHub

What Homing Pigeon does

Homing Pigeon sends text alerts from code or an agent to one verified US mobile number. The agent gets verify, send, and status tools; phone verification uses a code sent by text, and the key is saved on your machine.

Hooks can alert you when Claude Code or Codex finishes or waits for input. Cursor hooks report completion only because Cursor has no wait event. A turn sends an alert only after running for at least 5 minutes; set a different threshold with --after. Codex requires trusting the hooks with /hooks before they run.

To add it through Claude Code, run claude mcp add --transport http homingpigeondev https://homingpigeon.dev/mcp. You need a US mobile number that can receive the verification text.

What it helps with

  • get a text after an agent finishes a task
  • know when an agent is waiting for input
  • send an alert when a script fails
  • check the MCP connection status

Example prompts for the agent

  • Text me when you finish this task.
  • Send me a text if the build fails.
  • Let me know when you need a response.

How to install Homing Pigeon

1Platform CLI: remote server

claude mcp add --transport http homingpigeondev https://homingpigeon.dev/mcp

2Platform CLI

claude mcp add homing-pigeon -- npx -y homingpigeondev

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Homing Pigeon

How do I install Homing Pigeon in Claude Code?

Run claude mcp add --transport http homingpigeondev https://homingpigeon.dev/mcp. Then verify your mobile number with the code sent by text.

What does Homing Pigeon do?

It gives an agent tools to verify a phone number, send a text, and check status. Alerts go only to the verified US number.

What does Homing Pigeon need to work?

It needs a US mobile number that can receive a verification text. After verification, the agent saves the key on your machine.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open