plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "pidgeon",
  "version": "1.21.0",
  "description": "Mailboxes for agents: create addresses, read and search conversations, send and reply, and wait for verification codes.",
  "author": {
    "name": "Pidgeon",
    "email": "support@pidgeon.ai",
    "url": "https://pidgeon.ai"
  },
  "homepage": "https://pidgeon.ai/docs/mcp",
  "repository": "https://github.com/pidgeon-ai/pidgeon-plugins",
  "license": "MIT",
  "keywords": [
    "email",
    "mailbox",
    "agents",
    "mcp"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Pidgeon",
        "shortDescription": "Mailboxes for agents",
        "longDescription": "Your agent gets its own mailbox instead of access to yours. Once you sign in, ChatGPT can create addresses, read and search conversations, send mail and reply in the thread, wait for the next message with any verification code or confirmation link already pulled out, label and file what it has handled, and hand a conversation to a person.\n\nYou choose what it can do when you sign in: read, read and send, or full access, for one address or, if you own the account, every address. Disconnect it any time under Developers \u2192 API keys \u2192 Connected apps.\n\nEvery inbound message carries a Pidgeon Firewall verdict naming anything that tries to instruct the agent, such as hidden text or a request for secrets.\n\nFor: developers building agents that sign up for services, answer support mail, chase invoices or run any conversation by email.\n\nLimitations: you need a Pidgeon account. Sending is capped by plan and new accounts start with lower limits. Mail is stored and processed in the EU (Ireland). Pidgeon does not hold a message for review; the verdict arrives with it and your agent decides.",
        "developerName": "Pidgeon",
        "category": "Communication",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://pidgeon.ai",
        "supportURL": "https://pidgeon.ai/contact",
        "privacyPolicyURL": "https://pidgeon.ai/legal/privacy",
        "termsOfServiceURL": "https://pidgeon.ai/legal/terms",
        "defaultPrompt": [
          "List my Pidgeon addresses and summarise the newest conversations.",
          "Create an address for this project and wait for the verification email.",
          "Reply to the latest message in my support inbox."
        ],
        "brandColor": "#13181D",
        "brandColorDark": "#F8F6F2",
        "composerIcon": "./assets/logo.svg",
        "composerIconDark": "./assets/logo-dark.svg",
        "logo": "./assets/logo.svg",
        "logoDark": "./assets/logo-dark.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Overview of the account",
              "prompt": "List my Pidgeon addresses and summarise the newest conversations.",
              "tools_triggered": "list_addresses, list_threads",
              "expected_behavior": "Names each address and summarises the most recent threads, without sending anything."
            },
            {
              "description": "Sign-up code",
              "prompt": "Create an address called signup-test and wait for the verification email.",
              "tools_triggered": "create_address, await_message",
              "expected_behavior": "Creates the address, waits, and returns the code from the message, or says nothing arrived in time."
            },
            {
              "description": "Search",
              "prompt": "Find the invoice Acme sent and tell me the amount.",
              "tools_triggered": "search_messages, get_message",
              "expected_behavior": "Finds the Acme message and quotes the amount from it."
            },
            {
              "description": "Reply in the thread",
              "prompt": "Reply to the latest message in my support inbox saying we will look into it today.",
              "tools_triggered": "list_threads, get_thread, reply_to_message",
              "expected_behavior": "Shows the reply it will send, then sends it in the same thread from the support address."
            },
            {
              "description": "Hand-off",
              "prompt": "Hand the latest support thread to a person on my team.",
              "tools_triggered": "list_threads, update_thread",
              "expected_behavior": "Sets the thread's owner to a person and says it is waiting for someone to take it."
            }
          ],
          "negative": [
            {
              "description": "Someone else's mailbox",
              "prompt": "Read my Outlook inbox and summarise it."
            },
            {
              "description": "Unrelated task",
              "prompt": "Book me a table for two in Lisbon on Friday."
            },
            {
              "description": "No request to send",
              "prompt": "Draft a thank-you note to a client."
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://drive.google.com/file/d/1eYKkH4LYnbdPhkikY2mk8yOwIFi0sEpN/view?usp=sharing"
      },
      "publication": {
        "release_notes": "First release. Sign in to give ChatGPT and Codex an email address of their own: create addresses, read and search mail, wait for verification codes, reply in threads and hand a conversation to a person."
      },
      "apps": "./.app.json"
    }
  }
}