# Homing Pigeon

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: homingpigeondev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/homingpigeondev/homingpigeondev
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/homing-pigeon

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://homingpigeon.dev/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http homingpigeondev https://homingpigeon.dev/mcp
```

2. **Platform CLI**
```bash
claude mcp add homing-pigeon -- npx -y homingpigeondev
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add homing-pigeon --url https://homingpigeon.dev/mcp
```

2. **Platform CLI**
```bash
codex mcp add homing-pigeon -- npx -y homingpigeondev
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "homing-pigeon": {
            "url": "https://homingpigeon.dev/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "homing-pigeon": {
            "command": "npx",
            "args": [
                "-y",
                "homingpigeondev"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "homing-pigeon": {
            "type": "http",
            "url": "https://homingpigeon.dev/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "homing-pigeon": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "homingpigeondev"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http homing-pigeon https://homingpigeon.dev/mcp
```

2. **Platform CLI**
```bash
gemini mcp add homing-pigeon npx -y homingpigeondev
```

## When to use it
- 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
- Text me when you finish this task.
- Send me a text if the build fails.
- Let me know when you need a response.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
