com.po6/mailbox

Official39 tools

PO6 Mailbox

Give AI agents secure access to your email via private aliases with dedicated mailbox storage.

Secure email access for AI agents using private aliases and dedicated mailboxes.

Captured live from the server via tools/list.

list_mailboxes

List all mailboxes the API key has access to, with basic stats for each

No parameters.

get_mailbox_stats

Get detailed statistics for a specific mailbox including email counts, storage usage, and folder breakdown

Parameters (1)

mailbox_idstringrequired
The mailbox ID to get stats for

list_emails

List emails in a mailbox with optional filtering. Returns email metadata without full content.

Parameters (11)

mailbox_idstringrequired
The mailbox ID to list emails from
folderstring
Filter by folder (inbox, spam, archive, trash, or custom folder name)
limitnumber
Maximum number of emails to return (1-100)
offsetnumber
Number of emails to skip for pagination
unread_onlyboolean
Only return unread emails
starred_onlyboolean
Only return starred emails
from_filterstring
Filter by sender email address (partial match)
subject_containsstring
Filter by subject containing this text
sincestring
Only return emails received after this ISO 8601 date
untilstring
Only return emails received before this ISO 8601 date
has_attachmentsboolean
Only return emails with attachments

get_email

Get the full content of a specific email including body text, HTML, headers, and attachment metadata. To mark the email as read, use mark_email separately.

Parameters (2)

mailbox_idstringrequired
The mailbox ID containing the email
email_idstringrequired
The email ID to retrieve

search_emails

Search emails across one or all accessible mailboxes using text search

Parameters (3)

querystringrequired
Search query to match against sender, subject, and snippet
mailbox_idstring
Optional: limit search to a specific mailbox
limitnumber
Maximum number of results (1-50)

mark_email

Mark an email as read/unread or starred/unstarred

Parameters (4)

mailbox_idstringrequired
The mailbox ID containing the email
email_idstringrequired
The email ID to mark
is_readboolean
Set read status (true = read, false = unread)
is_starredboolean
Set starred status (true = starred, false = unstarred)

move_email

Move an email to a different folder

Parameters (3)

mailbox_idstringrequired
The mailbox ID containing the email
email_idstringrequired
The email ID to move
folderstringrequired
Target folder (inbox, spam, archive, trash, or custom folder name)

delete_email

Permanently delete an email. This action cannot be undone. Consider moving to trash first. Requires a two-step confirmation: first call returns a confirmation_token, second call with the token performs the deletion.

Parameters (3)

mailbox_idstringrequired
The mailbox ID containing the email
email_idstringrequired
The email ID to delete
confirmation_tokenstring
Confirmation token from the first call. Required to actually perform the deletion.

list_folders

List all folders in a mailbox including system folders and custom folders

Parameters (1)

mailbox_idstringrequired
The mailbox ID to list folders for

list_email_lists

List all email contact lists for the user. Email lists help organize contacts for outreach campaigns and bulk operations. Requires a paid plan (Standard or Plus).

No parameters.

get_email_list_contacts

Get contacts from a specific email list. Returns contact details including email, name, company, and status. Only active contacts can receive emails.

Parameters (4)

list_idstringrequired
The email list ID to get contacts from
statusstring
Filter by contact status (active, unsubscribed, bounced). Default: all statuses.
limitnumber
Maximum number of contacts to return (1-200)
offsetnumber
Number of contacts to skip for pagination

compose_email

Compose and send a new email to one or more recipients. Requires a paid plan (Standard or Plus). Rate limits vary by plan (Standard: 30/hr, 200/day; Plus: 60/hr, 500/day).

Parameters (5)

mailbox_idstringrequired
The mailbox ID to send from
to_addressesarrayrequired
List of recipient email addresses
subjectstringrequired
Email subject line
body_textstringrequired
Plain text body of the email
body_htmlstring
Optional HTML body. If not provided, body_text will be converted to HTML.

reply_email

Reply to an email. The reply will be sent from the mailbox's email address to the original sender. Rate limited per plan (Standard: 30/hr, Plus: 60/hr).

Parameters (4)

mailbox_idstringrequired
The mailbox ID containing the email to reply to
email_idstringrequired
The email ID to reply to
body_textstringrequired
Plain text body of the reply
body_htmlstring
Optional HTML body of the reply. If not provided, body_text will be used.

forward_email

Forward an email to one or more recipients. The forward will be sent from the mailbox's email address. Rate limited per plan (Standard: 30/hr, Plus: 60/hr). Max recipients per plan (Standard: 5, Plus: 10).

Parameters (4)

mailbox_idstringrequired
The mailbox ID containing the email to forward
email_idstringrequired
The email ID to forward
to_addressesarrayrequired
List of email addresses to forward to (max 5)
messagestring
Optional message to include above the forwarded email

list_templates

List email templates available for composing emails. Templates contain pre-written subject and body content with optional variables like {{first_name}} that can be filled in.

Parameters (2)

mailbox_idstring
Optional: filter templates for a specific mailbox. If omitted, returns all templates.
categorystring
Optional: filter by category (general, outreach, followup, newsletter)

get_template

Get the full content of an email template including subject, body, and variables.

Parameters (1)

template_idstringrequired
The template ID to retrieve

create_draft

Create a draft email for the user to review and approve before sending. This is the preferred way for AI agents to compose emails - the user can review, edit, and approve drafts from the web dashboard. Drafts expire after 72 hours if not acted on. Rate limited per plan.

Parameters (7)

mailbox_idstringrequired
The mailbox ID to create the draft for
to_addressesarrayrequired
List of recipient email addresses
subjectstringrequired
Email subject line
body_textstringrequired
Plain text body of the email
body_htmlstring
Optional HTML body. If not provided, body_text will be converted to HTML.
template_idstring
Optional: template ID to base the draft on
scheduled_atstring
Optional: ISO 8601 date to schedule the send for (e.g., "2025-01-15T09:00:00Z"). If set, the email will be sent at this time after approval.

list_drafts

List draft emails pending review. Shows drafts created by AI agents that the user can approve or reject.

Parameters (3)

mailbox_idstringrequired
The mailbox ID to list drafts for
statusstring
Filter by status: pending_review, approved, rejected, sent, expired
limitnumber
Maximum number of drafts to return (1-50)

list_sent_emails

List emails sent from a mailbox. Shows all sent emails whether sent by the user (web), AI agent (MCP), or API. Includes delivery status and sent_via source.

Parameters (4)

mailbox_idstringrequired
The mailbox ID to list sent emails for
sent_viastring
Optional: filter by how the email was sent
limitnumber
Maximum number of emails to return (1-100)
offsetnumber
Number of emails to skip for pagination

list_aliases

List all @po6.com forwarding aliases owned by the user. Returns alias address, forwarding destination, subscription plan, active status, and plus addressing settings.

Parameters (1)

active_onlyboolean
Only return active aliases

get_alias

Get detailed information about a specific @po6.com alias including forwarding destination, verification status, subscription plan, plus addressing, and URL redirect settings.

Parameters (1)

alias_idstringrequired
The alias ID to retrieve

update_alias

Update a @po6.com alias settings. Can change forwarding address (triggers re-verification), toggle active status, or configure plus addressing. Cannot create or delete aliases.

Parameters (5)

alias_idstringrequired
The alias ID to update
forward_tostring
New forwarding email address (will require re-verification)
is_activeboolean
Enable or disable the alias (requires active subscription)
plus_addressing_enabledboolean
Enable or disable plus addressing (e.g. alias+tag@po6.com)
plus_tag_auto_labelboolean
Automatically label forwarded emails with the plus tag

list_domains

List all custom (BYOD) domains owned by the user. Returns domain name, verification status, catchall config, alias count, and BYOD subscription plan with limits.

No parameters.

get_domain

Get detailed information about a custom domain including verification status, MX records, catchall configuration, aliases, and BYOD plan limits.

Parameters (1)

domain_idstringrequired
The domain ID to retrieve

update_domain_alias

Update a domain alias settings. Can change forwarding address (triggers re-verification), toggle active status (subject to plan limits), or configure plus addressing.

Parameters (6)

domain_idstringrequired
The domain ID containing the alias
alias_idstringrequired
The domain alias ID to update
forward_tostring
New forwarding email address (will require re-verification)
is_activeboolean
Enable or disable the alias (subject to plan active alias limit)
plus_addressing_enabledboolean
Enable or disable plus addressing
plus_tag_auto_labelboolean
Automatically label forwarded emails with the plus tag

update_catchall

Enable, disable, or update the catchall configuration for a custom domain. Catchall forwards all unmatched emails to a specified address. Changing the forward address requires re-verification.

Parameters (3)

domain_idstringrequired
The domain ID to configure catchall for
enabledboolean
Enable or disable catchall
forward_tostring
Email address to forward catchall emails to (required when enabling)

list_landing_page_templates

List available landing page templates. Returns template summaries including name, category, and preview information.

Parameters (1)

categorystring
Optional: filter templates by category

get_landing_page_template

Get full details of a landing page template by ID, including widget configuration and default content.

Parameters (1)

template_idstringrequired
The template ID to retrieve

list_landing_pages

List the user's landing pages with optional filtering by status. Returns page summaries including title, status, URL, and last modified date.

Parameters (3)

statusstring
Filter by landing page status
limitnumber
Maximum number of landing pages to return (1-100)
offsetnumber
Number of landing pages to skip for pagination

get_landing_page

Get a landing page's full details including widget configuration, SEO settings, linked alias/domain, and publication status.

Parameters (1)

page_idstringrequired
The landing page ID to retrieve

get_landing_page_stats

Get analytics and statistics for a landing page including page views, unique visitors, and lead conversion metrics.

Parameters (2)

page_idstringrequired
The landing page ID to get stats for
daysnumber
Number of days of stats to retrieve

list_landing_page_leads

List leads/form submissions captured by landing pages. Returns lead details including email, name, submission date, and source page.

Parameters (3)

page_idstring
Optional: filter leads to a specific landing page
limitnumber
Maximum number of leads to return (1-100)
offsetnumber
Number of leads to skip for pagination

create_landing_page

Create a new landing page from a template. The page is created in draft status. Optionally link it to a po6 alias or BYOD domain alias for URL routing.

Parameters (5)

template_idstringrequired
The template ID to create the landing page from
titlestring
Optional title for the landing page
alias_idstring
Optional: po6 alias ID to link this landing page to
domain_alias_idstring
Optional: BYOD domain alias ID to link this landing page to
domain_idstring
Optional: BYOD domain ID (required when using domain_alias_id)

update_landing_page

Update a landing page's configuration, title, or SEO settings. Pass the full widget config JSON to update the page layout and content.

Parameters (9)

page_idstringrequired
The landing page ID to update
titlestring
New title for the landing page
configstring
JSON string of the widget configuration for the page layout and content
meta_titlestring
SEO meta title for the page
meta_descriptionstring
SEO meta description for the page
og_image_urlstring
Open Graph image URL for social media sharing
favicon_urlstring
Custom favicon URL for the page
notify_on_leadboolean
Whether to send email notifications when a new lead is captured
lead_notify_emailstring
Email address to send lead notifications to

publish_landing_page

Publish a landing page, making it publicly accessible at its URL. Requires a two-step confirmation: first call returns a confirmation_token, second call with the token performs the publish.

Parameters (2)

page_idstringrequired
The landing page ID to publish
confirmation_tokenstring
Confirmation token from the first call. Required to actually perform the publish.

unpublish_landing_page

Unpublish a landing page, removing it from public access. The page returns to draft status. Requires a two-step confirmation: first call returns a confirmation_token, second call with the token performs the unpublish.

Parameters (2)

page_idstringrequired
The landing page ID to unpublish
confirmation_tokenstring
Confirmation token from the first call. Required to actually perform the unpublish.

assign_landing_page_domain

Assign a custom domain to a landing page so it can be accessed via that domain. Requires a two-step confirmation: first call returns a confirmation_token, second call with the token performs the assignment.

Parameters (3)

page_idstringrequired
The landing page ID to assign the domain to
domainstringrequired
The custom domain to assign (e.g., "landing.example.com")
confirmation_tokenstring
Confirmation token from the first call. Required to actually perform the domain assignment.

archive_landing_page

Archive (soft-delete) a landing page. If the page is published, it will be unpublished first. Requires a two-step confirmation: first call returns a confirmation_token, second call with the token performs the archive.

Parameters (2)

page_idstringrequired
The landing page ID to archive
confirmation_tokenstring
Confirmation token from the first call. Required to actually perform the archive.

download_landing_page

Download a published landing page as a standalone HTML file. Returns the full HTML content of the page. The page must be published.

Parameters (1)

page_idstringrequired
The landing page ID to download

Install

claude_desktop_config.json

{
  "mcpServers": {
    "mailbox": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.po6.com"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.