connect_mailbox
Connect the user's own inbox with an APP PASSWORD (Gmail: 2-step verification on, then Google Account → Security → App passwords).
What it does
Connect the user's own inbox with an APP PASSWORD (Gmail: 2-step verification on, then Google Account → Security → App passwords). Never ask for the normal account password. purpose lifecycle = product email for journeys: Gmail or Google Workspace only, any plan, ready at once with no warmup. purpose outbound (default) = cold outreach from their own inbox: Business plan only; warmup starts on its own and the response says when it's ready. For a group or alias address such as hello@, username is the Google account whose app password it is, and that account must list the address under Gmail Settings → Accounts → Send mail as. SMTP and IMAP are verified before anything is stored. Re-running for an existing address rotates its credentials.
Parameters
| Name | Type | Notes |
|---|---|---|
| email * | string | The mailbox address, e.g. jane@gmail.com |
| password * | string | App password for that account (not the login password) |
| display_name | string | From name, e.g. 'Jane from Acme' |
| username | string | Login id when it differs from the address |
| purpose | outbound | lifecycle | lifecycle = product email (Gmail); outbound = cold outreach (Business) |
| smtp_host | string | |
| smtp_port | number | 587 (STARTTLS) or 465 (TLS) |
| imap_host | string | |
| imap_port | number | Usually 993 |
| daily_limit | number | outbound: default 30, capped at 30 a day; lifecycle: default 500, Gmail's own cap |
* required
More mailboxes tools
See all 147 tools and the connection string on the MCP server page.