# Pigeonpost

> Pigeonpost is a freemium MCP server for communication. Give an AI agent a permanent address and an encrypted inbox for async messages. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI
- **Website:** https://pigeonpost.dev
- **Repository:** https://github.com/bekirdag/pigeonpost
- **MCP Registry name:** io.github.bekirdag/pigeonpost
- **Categories:** communication, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

```json
{
  "mcpServers": {
    "pigeonpost": {
      "command": "npx",
      "args": [
        "-y",
        "@bekirdag/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

- [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/pigeonpost
