Mail Merge for Gmail

Permanently deletes a template. Confirm with the user first; this cannot be undone.

delete_template

Copies a template (body, subject and attachments) into a new one named '<name> (copy)'. With `owner`, copies a teammate's shared template into this account's own library under its original name.

duplicate_template

Professional plan. Writes one short personalization snippet per row with AI — e.g. an icebreaker from the Company and Website columns — and returns it as a value for a merge tag. Nothing is sent or saved. Max 100 rows per call, 2000 rows per day. To use the values: put `{{<field name>}}` in the subject or body and pass each row's value in send_campaign's per-recipient `fields` under the same name (or write it into a sheet column of that name).

generate_ai_field

Writes and saves an email template with Mail Merge's AI from a plain-language brief (`prompt`), or saves the exact `subject` + `content` you pass, or a sample template (`useSampleValues`). If the user asked for a template but gave no details, ask for the goal, audience and tone first, or offer `useSampleValues`. Optionally also creates a sample Google Sheet with the merge-tag columns (`createSampleSpreadsheet`). After it succeeds, show the user the template name, subject and the sheet link if one was created.

generate_template

Returns the signed-in Mail Merge account: email, plan (free / personal / professional), daily sending quota (max, used today, remaining), whether Google access is connected, and a `features` map saying which features this plan can use (autopilot, followUps, abTesting, warmup, verification, deliverabilityHub, apiKeys, webhooks, aiFields, teamAnalytics, analytics, sharedTemplates, scheduling, tracking), and `team` (role owner/member and size) when the account is on a team subscription. Call it first in a session, and before planning anything that depends on the plan or the quota.

get_account

Account events log: campaign launched / completed / paused, quota deferrals, Gmail cooldowns, access revoked, billing changes. Newest first, paginated.

get_account_events

The recipient activity feed: who opened, clicked, replied, bounced or unsubscribed, newest first. Paid plans only. Paginated with nextCursor.

get_activity

Account-level engagement analytics for a period: emails sent, opens, clicks, replies and bounces per campaign, daily time series, most engaged contacts and most clicked links. Paid plans only; a free account gets the sent total and an upgrade link. scope 'team' (Professional, subscription owner only) folds every seat member's sends into the same report, each campaign tagged with its sender.

get_analytics

Returns one campaign's details; when it is part of a follow-up sequence, the per-step statistics (each step's condition and skips); when it runs an A/B subject test, the per-variant results (`abTest`: sent, opened, clicked, replied, rates, the auto-picked winner).

get_campaign

Lists a campaign's recipients with their status (In queue, Sent, Read, Clicked, Replied, Bounced, Error, Unsubscribed…). Replied/Bounced are detected on paid plans for 14 days after a campaign finishes. Paginated with nextCursor.

get_campaign_recipients

Per-step statistics of a follow-up sequence: sent, opened, clicked, replied, skipped per step, each step's audience condition and how many it left out (conditionNotMet), and the first step's A/B subject test results when it ran one.

get_sequence_stats

Returns one template in full: name, subject, HTML body and settings. With `owner`, reads a teammate's shared template (read-only; duplicate_template copies it into this account).

get_template

Status of the email warm-up (automated peer-to-peer exchanges that build the sender's reputation): active/paused, today's target and sent count, reputation band, 7-day stats. Warm-up is enabled by the user in the web app (setupUrl in the result), not by a tool.

get_warmup

Creates a template from a Google Docs document the user owns or can read: the document's formatted text becomes the HTML body and its title the template name. Needs the user's Google access.

import_google_doc

Adds up to 500 contacts in one call (chunk larger lists). Each contact is an email plus optional merge fields that appear in the email. Emails already in the book are skipped (their fields are not changed); the result says how many were imported and skipped.

import_contacts

Lists the account's campaigns in three buckets: ongoing (sending or paused), scheduled (not started yet, autopilot included) and completed (finished or stopped). Free accounts keep completed campaigns for 3 days only.

list_campaigns

Lists the account's contact lists (id, name, created). A list is a named group of contacts a campaign can be sent to.

list_contact_lists

Lists the account's contacts with their merge fields, campaign count, unsubscribed/blocked flags and list memberships. Paginated: pass the returned nextCursor to get the next page.

list_contacts

Lists the tabs (sheets) of a Google Sheets spreadsheet with their numeric ids, from a link or id. Use it before read_sheet or send_campaign when the spreadsheet has several tabs.

list_sheets

Lists the user's Google Sheets spreadsheets (id, title, last modified, URL), newest first, optionally filtered by title. Needs Google Drive read access: when the result says google_grant_required, give the user the reconnectUrl it carries, or simply ask them to paste the spreadsheet link instead — list_sheets and read_sheet work from a link without this permission.

list_spreadsheets

Lists email templates (id, name, subject, last edited). Bodies are not included; call get_template for one. scope 'team' lists the templates teammates share through the team subscription, each with its `owner` email — pass that owner to get_template or duplicate_template.

list_templates

Pauses an ongoing campaign; queued emails wait until resume_campaign.

pause_campaign

Pauses the warm-up; the ramp history is kept.

pause_warmup

Reads a tab of a Google Sheets spreadsheet: the header row (these are the merge tags, usable as {{Header}} in a template), a preview of the data rows, the total row count and the column that holds the recipient emails. Use it to understand a sheet before sending; pass the same spreadsheet and sheetTitle to send_campaign.

read_sheet

Removes contacts from a list without deleting them.

remove_contacts_from_list

Renames a contact list.

rename_contact_list

Moves a scheduled campaign to another start time. Check the new day's quota with check_quota first.

reschedule_campaign

Resumes a paused campaign (also one the system paused for a Gmail restriction, once the user has fixed it). Sending through Gmail starts again at the next sweep.

resume_campaign

Resumes a paused warm-up.

resume_warmup

Sends (now, at a scheduled time, or on autopilot) a personalised campaign with a template to recipients from a Google Sheet, a contact list or an inline list. RULES: 1) Never call it without the user's explicit confirmation that names the recipient count, the template and the send time. 2) Call it with dryRun: true first and show the user the summary (recipient count, quota, skipped rows). 3) Merge tags in the template must match the sheet headers / contact field names; check with read_sheet or list_contacts. Autopilot and followUp need the Professional plan; a quota overrun answers quota_exceeded with the reset time — on a paid plan retry with autoContinue: true (what fits goes today, the rest continues daily), otherwise offer to schedule for later or to upgrade. The sheet gets a status column that the user can watch in Google Sheets.

send_campaign

Sends ONE rendered email to the user's own address (or another address they name) so they can check the template before a campaign. Merge tags are filled from `substitutions`; the tracking pixel is omitted.

send_test_email

Sets the account's default pause between two emails of a campaign, in minutes: 0 sends as fast as Gmail allows, a number is a fixed pause, [min, max] a random pause. Campaigns that pass their own throttleIntervalMinutes override it.

set_throttle

Stops a campaign for good: queued emails are cancelled and their quota refunded. Cannot be resumed. Confirm with the user first.

stop_campaign

Stops the warm-up and deletes the stored app password and ramp history. Confirm with the user first.

stop_warmup

Removes emails from the blocklist. Does not undo an unsubscribe the recipient made themselves.

unblock_contacts

Changes a running autopilot campaign's days, window, daily cap or interval. Professional plan only.

update_autopilot

Changes a template's name, subject, body and/or unsubscribe setting. Fields left out keep their current value; a field passed REPLACES the stored one and the previous version is not kept — confirm with the user before overwriting a body.

update_template

Changes the warm-up ramp: the daily maximum and how many more emails each day adds.

update_warmup_settings

Professional plan. Verifies a list of recipient addresses before a send: each comes back valid, risky (role address such as info@, or a domain on a blocklist) or invalid (bad syntax, disposable domain, no mail server, or it bounced in an earlier campaign) with a reason code. No email is sent to the addresses. Verdicts are cached for 30 days on the sender's contact book; 5000 fresh addresses per day. Afterwards, send_campaign with skipInvalidRecipients: true skips the invalid ones automatically.

verify_recipients