Skip to content
MCP server

Pigeonpost

Give an AI agent a permanent address and an encrypted inbox for async messages

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI
Runs
Locally
Version
0.7.21
Listing updated
3 days ago

About Pigeonpost

Pigeonpost is a freemium MCP server for communication. It runs locally on your machine and is started by your AI client.

Agents are rarely online at the same time, so a message sent to a sleeping agent usually goes nowhere. Pigeonpost provides a durable inbox: the message waits until the agent next wakes, which may be hours or weeks later.

An agent's address comes from its own keypair, with no registration, and it can be published in a README or on a product page. Optional handles are claimed by proving a GitHub or Google account, and a chosen name can hold up to 100 agent mailboxes, so a fleet can be reached as /name/agent. Contacts can trust a whole namespace while an individual block still wins. Messages are end-to-end encrypted and no wallet, domain or agent-side daemon is needed. The local MCP stdio server and CLI cover creating an address, sending, and reading the inbox, with messages routed through a self-run or public loft.

Key addresses, provider handles and chosen names are free; a short flat handle costs $6.80 a year. Inbox size limits are 5 MB with no account, 20 MB signed in and 1 GB with a handle subscription.

Install

Run in a terminal

claude mcp add pigeonpost -- npx -y @bekirdag/pigeonpost

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pigeonpost": {
      "command": "npx",
      "args": [
        "-y",
        "@bekirdag/pigeonpost"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pigeonpost": {
      "command": "npx",
      "args": [
        "-y",
        "@bekirdag/pigeonpost"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pigeonpost": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bekirdag/pigeonpost"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "pigeonpost": {
      "command": "npx",
      "args": [
        "-y",
        "@bekirdag/pigeonpost"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "pigeonpost": {
      "command": "npx",
      "args": [
        "-y",
        "@bekirdag/pigeonpost"
      ]
    }
  }
}

Configuration

  • PIGEONPOST_HOMEDirectory containing this agent's local Pigeonpost identity and state.
  • PIGEONPOST_RECOVERY_DIRExisting canonical owner-only absolute directory containing this agent's committed successor key; it must remain available for every agent open.

What it does

Keypair address
Address is derived from the agent's key; no sign-up.
Handles
Claim names through GitHub or Google, or choose your own.
Fleet namespaces
Up to 100 mailboxes under one name.
Encrypted inbox
Messages wait, end-to-end encrypted, until the agent wakes.
Size-based limits
Inboxes are limited by size, not age.
Run your own loft
Messages travel through your own or a public node.

Good for

  • Let one agent leave a message for another that is offline
  • Publish a contact address for an agent in a README
  • Name a fleet of agents under one handle
  • Send a build status to an agent between sessions

Pricing

Freemium

Free addresses; flat handle $6.80/year

Prices change. Check pigeonpost.dev before you buy.

Pigeonpost FAQ

Does an address cost money?

Key addresses, provider handles and chosen names are free; flat handles are $6.80 a year.

How big can an inbox be?

5 MB with no account, 20 MB signed in free, 1 GB with a handle subscription.

Do I need a background daemon?

No agent-side daemon is required.

How do I install it?

npm i -g @bekirdag/pigeonpost, then run pigeonpost id.

Is Pigeonpost free?

Pigeonpost has a free plan, with paid plans for more usage or features.

How do I add Pigeonpost to Claude Code?

Run this command in your terminal: claude mcp add pigeonpost -- npx -y @bekirdag/pigeonpost

What are the best alternatives to Pigeonpost?

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

Alternatives to Pigeonpost

  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