PO6 Mailbox#

Manage your PO6 email aliases, mailbox, and landing pages through natural language.

PO6 gives you short, memorable email addresses like you@po6.com or email on your own domain. This skill connects to the PO6 MCP server so you can manage everything conversationally.

Setup#

1. Get a PO6 account and API key#

1. Sign up at po6.com
2. Go to Dashboard > Mailbox > API Keys
3. Create a new API key with the scopes you need
4. Copy the key (starts with mcp_po6_)

2. Set your API key#

bash

export PO6_API_KEY="mcp_po6_your_key_here"

Or add it to your shell profile ( ~/.zshrc, ~/.bashrc) for persistence.

3. Add the MCP server#

Add to ~/.openclaw/openclaw.json under mcpServers:

json

{
  "mcpServers": {
    "po6-mailbox": {
      "type": "streamable-http",
      "url": "https://mcp.po6.com",
      "headers": {
        "Authorization": "Bearer ${PO6_API_KEY}"
      }
    }
  }
}

Or run the included setup script:

bash

./scripts/setup.sh

4. Restart OpenClaw#

Restart to pick up the new MCP server.

Core Tasks#

• "Check my inbox for unread emails"
• "Send an email to alice@example.com about the project update"
• "Search my emails for invoices from last month"
• "Reply to the latest email from Bob saying I'll be there at 3pm"
• "Create a draft email to the team about the new schedule"
• "List my aliases and show which ones are active"
• "Create a landing page for our spring sale using the marketing template"

Available Tools#

Mailbox Management (13 tools)#

ToolDescriptionlist_mailboxesList all accessible mailboxesget_mailbox_statsGet mailbox statistics (counts, storage, folders)list_emailsList emails with filters (folder, sender, date, unread, starred)get_emailRead full email content, headers, and attachmentssearch_emailsSearch emails by query across sender, subject, and contentmark_emailMark emails as read/unread or starred/unstarredmove_emailMove emails between foldersdelete_emailPermanently delete an email (two-step confirmation)list_foldersList all folders in a mailboxlist_email_listsList contact/mailing listsget_email_list_contactsGet contacts from a mailing listlist_draftsList draft emails pending reviewlist_sent_emailsList sent emails with delivery status

Email Sending (4 tools)#

ToolDescriptioncompose_emailSend a new email from your alias (requires paid plan)reply_emailReply to an emailforward_emailForward an email to other recipientscreate_draftCreate a draft for your review before sending

Templates (2 tools)#

ToolDescriptionlist_templatesBrowse email templatesget_templateGet template details and variables

Aliases & Domains (7 tools)#

ToolDescriptionlist_aliasesList your @po6.com aliasesget_aliasGet alias details and forwarding configupdate_aliasUpdate alias settings (forwarding, active, plus addressing)list_domainsList your custom (BYOD) domainsget_domainGet domain details (verification, MX, catchall)update_domain_aliasUpdate a domain aliasupdate_catchallEnable/disable catchall forwarding

Landing Pages (13 tools)#

ToolDescriptionlist_landing_page_templatesBrowse available page templatesget_landing_page_templateGet template detailslist_landing_pagesList your pages (draft/published/archived)get_landing_pageGet page content, config, and SEO settingscreate_landing_pageCreate a new page from a templateupdate_landing_pageUpdate page content, SEO, and settingspublish_landing_pagePublish a landing page (two-step confirmation)unpublish_landing_pageUnpublish a page to draft (two-step confirmation)archive_landing_pageArchive a landing page (two-step confirmation)assign_landing_page_domainAssign a custom domain (two-step confirmation)download_landing_pageDownload page as standalone HTMLget_landing_page_statsView analytics (views, visitors, conversions)list_landing_page_leadsView form submissions and leads

Environment Variable Contract#

VariableRequiredDescriptionPO6_API_KEYYesYour PO6 API key (starts with mcp_po6_). Get it from po6.com/dashboard/mailbox.

API Key Scopes#

When creating your API key, select the scopes you need. Start with read-only scopes and add write scopes as needed.

ScopeAccessmailbox:listList mailboxes, folders, email summariesmailbox:readRead full email content and attachmentsmailbox:searchSearch emailsmailbox:writeMark, move emailsmailbox:deleteDelete emailsmailbox:sendSend, reply, forward emailsalias:listList aliases and domainsalias:readRead alias/domain detailsalias:writeUpdate alias and domain settingslanding_page:listList pages and templateslanding_page:readRead page content and statslanding_page:writeCreate, update, archive pageslanding_page:publishPublish/unpublish pageslanding_page:leadsAccess lead/form submission datalanding_page:domainManage custom domains on pages

Rate Limits#

LimitValueAPI requests60/minute per key (configurable)Email sending (Standard)30/hour, 200/day, 3,000/monthEmail sending (Plus)60/hour, 500/day, 10,000/monthEmail sending (Premium)100/hour, 500/day, 15,000/monthBrute force protection15 failed attempts in 15 min triggers 15 min lockout

External Endpoints#

This skill communicates only with:

• https://mcp.po6.com — PO6 MCP server (all tool calls)

No other external endpoints are contacted.

Security & Privacy#

• Secrets handling: Your API key is stored locally in your environment and never logged or sent to third parties. The key is transmitted only in the Authorization header over TLS to mcp.po6.com.
• Server-side hashing: API keys are SHA-256 hashed on the server. PO6 cannot see your key after creation.
• IP allowlists: Optionally restrict key usage to specific IP addresses (CIDR notation supported).
• Key expiration: Keys can be set to auto-expire on a date you choose.
• Confirmation for destructive actions: delete_email, publish_landing_page, unpublish_landing_page, archive_landing_page, and assign_landing_page_domain all require two-step confirmation before execution.
• Audit trail: All API calls are logged and visible in your PO6 dashboard.
• Scope isolation: Keys can be restricted to specific mailboxes and specific scopes, following the principle of least privilege.
• No external storage: No data is stored outside your PO6 account.

Troubleshooting#

ErrorFixPO6_API_KEY not setExport the variable in the shell that runs OpenClaw. Run echo $PO6_API_KEY to verify.Authentication failedCheck that your key starts with mcp_po6_ and hasn't expired. Generate a new key from your dashboard if needed.Rate limited (-32002)Wait a minute and retry. If you need higher limits, upgrade your plan or contact support.Insufficient scopesYour API key lacks permission for that action. Create a new key with the required scopes from your dashboard.IP not allowedYour key has an IP allowlist and your current IP is not on it. Update the allowlist in your dashboard.

Support#

• Documentation: po6.com/docs/mcp
• Dashboard: po6.com/dashboard
• Contact: support@po6.com