Skip to content
MCP server

Homing Pigeon

Text alerts from your code or coding agent to your own phone, with no carrier registration

Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally or Remotely
Version
0.1.4
Listing updated
3 days ago

About Homing Pigeon

Homing Pigeon is a freemium MCP server for communication. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://homingpigeon.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "homingpigeondev": {
      "url": "https://homingpigeon.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium, from $19 a month

50 free texts/month; $19/mo for 1,000 texts

Prices change. Check homingpigeon.dev before you buy.

Homing Pigeon 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 to Homing Pigeon

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools