# Homing Pigeon

> Homing Pigeon is a freemium MCP server for communication. Text alerts from your code or coding agent to your own phone, with no carrier registration. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** CLI, API
- **Website:** https://homingpigeon.dev
- **Repository:** https://github.com/homingpigeondev/homingpigeondev
- **MCP Registry name:** dev.homingpigeon/homingpigeondev
- **Categories:** communication, developer tools
- **Listing updated:** 2026-11-14

## About

A narrow idea: every message goes only to the US mobile number you verified, and there is no recipient field to get wrong. Setup runs inside the agent session. The agent submits your number, a six-digit code is texted to you, you read it back, and the agent stores the resulting API key in your project.

The MCP server exposes three tools: verify, send and status. Hooks for Claude Code, Codex and Cursor can text you when a long run ends, and Claude Code and Codex can also text when waiting on you; by default a turn only texts if it ran for at least five minutes, adjustable with --after. Hooks send the agent name and folder name, never prompts or replies.

Outside agents there is a CLI, a Python package and a plain curl call, so cron jobs, scrapers and bots can use the same alert. In Claude or ChatGPT you can add the hosted URL as a custom connector and sign in with a phone number and code.

## Features

- **Verify by agent:** The agent completes phone verification and saves the key.
- **Only your number:** Messages go to the verified US number; there is no recipient field.
- **Run-finished hooks:** Text when a Claude Code, Codex or Cursor run ends.
- **Waiting alerts:** Claude Code and Codex can text when they need you.
- **Script and API use:** CLI, Python package and curl for any code.
- **Hosted connector:** Add the URL in Claude or ChatGPT.

## Good for

- Get a text when a long coding-agent run finishes
- Alert yourself when a nightly job fails
- Page yourself from a trading bot or monitor
- Know when an agent is blocked waiting for input

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://homingpigeon.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "homingpigeondev": {
      "url": "https://homingpigeon.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "homingpigeondev": {
      "type": "http",
      "url": "https://homingpigeon.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "homingpigeondev": {
      "serverUrl": "https://homingpigeon.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "homingpigeondev": {
      "type": "http",
      "url": "https://homingpigeon.dev/mcp"
    }
  }
}
```

## Tools

- `verify`: Verifies your phone with a six-digit code.
- `send`: Sends a text alert to your verified phone.
- `status`: Shows account and sending status.

## FAQ

### What does it cost?

50 free texts a month, then $19 a month for 1,000 texts.

### Do I need carrier registration?

No brand, campaign or 10DLC forms are needed.

### Which numbers work?

The README says messages go to the US mobile number you verified.

### Which tools does the server give an agent?

verify, send and status.

### Is Homing Pigeon free?

Homing Pigeon has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

### How do I add Homing Pigeon to Claude Code?

Run this command in your terminal: claude mcp add --transport http homingpigeondev https://homingpigeon.dev/mcp

### What are the best alternatives to Homing Pigeon?

The closest alternatives to Homing Pigeon are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/homing-pigeon
