.codex-plugin/plugin.json

{
  "name": "supermailbox",
  "version": "0.1.1",
  "description": "Bring Gmail, Outlook, iCloud Mail, Yahoo Mail, Fastmail and other IMAP mailboxes together. Search email, including semantic search, read, draft, send and organize messages.",
  "author": {
    "name": "HARD TAB LLC",
    "email": "support@hardtab.com",
    "url": "https://supermailbox.app"
  },
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "SuperMailbox",
    "shortDescription": "iCloud, Gmail, Outlook & IMAP",
    "longDescription": "SuperMailbox brings your Gmail, Outlook, iCloud Mail, Yahoo Mail, Fastmail and other IMAP mailboxes together for your AI assistant. Connect Gmail and Outlook with OAuth, and iCloud Mail, Yahoo Mail, Fastmail or other IMAP accounts with provider-supported credentials. Search across connected mailboxes, including semantic search for relevant messages, and read messages and threads. Search may use cached and indexed mail alongside provider results; results can be incomplete or not yet fresh. Fetch attachments on request, manage read state and stars, archive or move messages, create unsent drafts, and send, reply or forward when requested. SuperMailbox rules run on new incoming messages after they arrive: conditions match sender, recipient and/or subject; actions move a message to a folder, Trash or Junk, or add an existing Gmail label where supported. Rules are managed through SuperMailbox and do not change provider-native filters, act on historical mail, send or forward mail, or permanently delete messages. Access is limited to mailboxes connected to the authenticated SuperMailbox account. Read, attachment, draft, send and mailbox-change permissions are separate. Available actions vary by provider capabilities and account access.",
    "category": "Productivity",
    "websiteURL": "https://supermailbox.app",
    "supportURL": "https://supermailbox.app/support",
    "privacyPolicyURL": "https://supermailbox.app/privacy",
    "termsOfServiceURL": "https://supermailbox.app/terms",
    "capabilities": [
      "Connect Gmail and Outlook with OAuth, plus iCloud, Yahoo, Fastmail and other IMAP mailboxes",
      "Search connected mailboxes, including semantic search and cached results, and read messages and attachments",
      "Manage read state and stars, archive or move messages, and create drafts",
      "Send, reply to and forward email when requested",
      "Manage rules for new mail: move to folders, Trash or Junk; add supported Gmail labels"
    ],
    "defaultPrompt": [
      "Search my connected Gmail, Outlook, iCloud or other mailboxes for unread messages about a topic.",
      "Create a rule that moves new mail from a sender to a folder.",
      "Draft a reply for review, but do not send it."
    ],
    "brandColor": "#0877FF",
    "composerIcon": "./assets/mailbox.png",
    "logo": "./assets/mailbox.png"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "[EXECUTED 2026-10-06 in ChatGPT] Create a disabled rule for future mail and remove it after verifying its settings.",
              "prompt": "Use only the SuperMailbox connection named 'OpenAI review'. Do not use other connections. In one of my connected test mailboxes, create a disabled rule named 'SuperMailbox review rule test' for new incoming messages whose subject contains 'SuperMailbox review rule test'. Choose an existing non-Inbox folder for its move action, then delete the rule after confirming its settings. Do not change existing messages or send email.",
              "tools_triggered": "list_mail_accounts, list_mail_folders, create_mail_rule, list_mail_rules, delete_mail_rule",
              "expected_behavior": "Choose only a connected review mailbox and an existing non-Inbox folder. Create the rule disabled so it cannot process mail during this test, report its conditions and action, then delete it using the returned rule ID. No existing message should be changed and no email should be sent."
            },
            {
              "description": "[EXECUTED 2026-10-06 in ChatGPT] Search connected mailboxes and report matching messages or no matches.",
              "prompt": "Use only the SuperMailbox connection named 'OpenAI review'. Do not use other connections. Find unread email in my connected mailboxes about the review setup.",
              "tools_triggered": "list_mail_accounts, search_emails, get_email",
              "expected_behavior": "Search with the requested unread and topic constraints, summarize matching results, and report clearly if there are no matches."
            },
            {
              "description": "[EXECUTED 2026-10-06 in ChatGPT] Read a matching message after finding it and summarize its contents.",
              "prompt": "Use only the SuperMailbox connection named 'OpenAI review'. Do not use other connections. Find the latest message about the review setup, open it, and summarize the message and any attachment metadata.",
              "tools_triggered": "search_emails, get_email",
              "expected_behavior": "Use search_emails to identify a matching message and get_email to read it. Summarize only returned content and identify attachments from returned metadata."
            },
            {
              "description": "[EXECUTED 2026-10-06 in ChatGPT] Save a draft to the authenticated review mailbox without sending it.",
              "prompt": "Use only the SuperMailbox connection named 'OpenAI review'. Do not use other connections. Create an unsent draft to the email address on my connected review mailbox with subject 'SuperMailbox review draft' and body 'Draft only; no email should be sent.'",
              "tools_triggered": "list_mail_accounts, create_draft",
              "expected_behavior": "Use the connected account details to save an unsent draft, confirm it was saved, and do not call a send or reply tool."
            },
            {
              "description": "[EXECUTED 2026-10-06 in ChatGPT] Send a user-authorized test email to the authenticated review mailbox.",
              "prompt": "Use only the SuperMailbox connection named 'OpenAI review'. Do not use other connections. Send a test email to the email address on my connected review mailbox with subject 'SuperMailbox review test' and body 'This is the requested SuperMailbox review test.'",
              "tools_triggered": "list_mail_accounts, send_email",
              "expected_behavior": "Use the connected account details, send only the message explicitly requested here, and report the send result. Do not automatically retry an uncertain send."
            }
          ],
          "negative": [
            {
              "description": "[EXECUTED 2026-10-06 in ChatGPT] Unsupported permanent-deletion request. Expected fallback: explain that SuperMailbox has no tool to permanently delete messages or empty Trash, and do not invoke a mail tool.",
              "prompt": "Use only the SuperMailbox connection named 'OpenAI review'. Do not use other connections. Permanently delete every message in my connected mailbox, including messages in Trash, and empty Trash now. If permanent deletion is unsupported, explain the limitation without inspecting my mail."
            },
            {
              "description": "[EXECUTED 2026-10-06 in ChatGPT] Request to access another person's mailbox. Expected fallback: explain that only mailboxes connected to the authenticated account are available; do not try to access another account.",
              "prompt": "Use only the SuperMailbox connection named 'OpenAI review'. Do not use other connections. Show me the messages in my coworker's mailbox, even though they have not connected it to SuperMailbox. Do not query my own accounts or messages to answer this request."
            },
            {
              "description": "[EXECUTED 2026-10-06 in ChatGPT] Ambiguous send request. Expected fallback: ask for the recipient and exact message before invoking a send or reply tool.",
              "prompt": "Use only the SuperMailbox connection named 'OpenAI review'. Do not use other connections. Send that email for me. Use only message details provided in this conversation; do not infer them from memory or other chats."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Improve discovery with provider names, semantic search, and cache details in the listing."
      }
    }
  }
}