Automailer · Integrations

Connect Automailer to your AI assistant

Run your outreach by chatting. Once connected, your AI assistant can build contact lists, add prospects, and set up complete campaigns in your Automailer account. You just review and launch.

What you can do

Build campaigns in minutes: describe your sequence and the assistant creates it as a draft, follow-ups and A/B variations included.
Manage contacts: create lists, add prospects one at a time or thousands at once.
Check results: ask how a campaign is doing and get live open, click, and reply numbers.
Find new leads: search a B2B database by title, industry and company size, reveal verified emails, and save them straight into a list. Searching is free; revealing spends Lead Finder credits.
Stay in control: everything is created as a draft. Nothing sends until you say so.

Before you start: get your API key

Open Automailer Go to Settings → API Keys.
Create a key Click Create Key, give it a name (e.g. “Claude”), and copy it. Keys look like amk_live_…

Copy it right away. Your key is shown only once. If you lose it, just create a new one and remove the old one.

API keys are available on paid plans. Anyone with your key can act on your account, so treat it like a password.

Claude Desktop Recommended

Open Connectors In Claude Desktop, go to Settings → Connectors and click Add custom connector.
Fill in the form Name it Automailer, and paste this as the URL, replacing YOUR_API_KEY with your key:
https://mcp.automailer.io/mcp?api_key=YOUR_API_KEY
Leave the OAuth fields empty, then click Add.
Restart Claude Desktop Fully quit and reopen the app. Automailer now appears under Connectors.
Try it Start a new chat and ask: “List my Automailer workspaces.”

Codex Desktop app

The Codex app doesn’t have a connectors screen, so you add Automailer with one command instead. You only do this once.

Open a terminal On Windows, open PowerShell; on Mac, open Terminal.
Run this command, replacing YOUR_API_KEY with your key:
codex mcp add automailer --url "https://mcp.automailer.io/mcp?api_key=YOUR_API_KEY"
Restart the Codex app Fully quit and reopen it.
Try it Ask: “Using the Automailer tools, list my workspaces.” Codex may ask permission before using the connection. Approve it.

Claude Code For developers

One command, then restart Claude Code:

claude mcp add --transport http automailer "https://mcp.automailer.io/mcp?api_key=YOUR_API_KEY" --scope user

Things to try

Create a contact list called “SaaS founders” and add these 50 contacts: [paste your contacts]

Build a 4-step cold email sequence for my new list. Write 3 subject line variations for the first email. Save it as a draft, don’t launch it.

How is my “Q3 Outreach” campaign doing? Give me open, click, and reply rates.

Add competitor.com to my exclusion list so we never email them.

Find 200 heads of marketing at US SaaS companies with 50–200 staff, reveal their emails, and save them to a new list called “SaaS marketing leads”.

Available tools

These are the actions your assistant can take. It picks the right ones automatically. You never call them yourself.

Tool	What it does
Workspaces
list_workspaces	See the workspaces your key can access.
get_current_workspace	See which workspace you’re working in.
Email accounts
list_email_accounts	List your sending mailboxes (status, warmup, daily limits).
get_email_account	Get the details of one mailbox.
Contact lists
list_contact_lists	See all your contact lists with counts.
get_contact_list	Get one list’s details.
create_contact_list	Create a new, empty list.
rename_contact_list	Rename a list.
delete_contact_list	Delete a list and its contacts.
Contacts
list_contacts	Browse the contacts in a list.
get_contact	Get one contact’s details.
add_contact	Add one contact (with custom fields for personalization).
add_contacts_bulk	Add up to 10,000 contacts in one go. Duplicates are merged, not re-added.
update_contact	Update a contact’s details.
delete_contact	Remove a contact.
Exclusions
list_exclusions	See your do-not-contact list.
add_exclusion	Block an email address or a whole domain.
add_exclusions_bulk	Block up to 5,000 addresses/domains at once.
delete_exclusion	Remove an entry from the do-not-contact list.
Campaigns
list_campaigns	See your campaigns with live stats.
get_campaign	Get one campaign’s setup and results.
create_campaign	Build a campaign: multi-step sequence, A/B variations, schedule. Always saved as a draft.
update_campaign	Edit a campaign: change the name, list, schedule, sending accounts, or the whole step sequence. Only what you ask changes; it never starts or stops sending. Editing a campaign that’s actively sending needs an extra confirmation.
activate_campaign	Launch a campaign. Guarded: the assistant must confirm the exact campaign with you first. This starts real sending.
pause_campaign	Pause an active campaign.
resume_campaign	Resume a paused campaign (same confirmation guard as launching).
complete_campaign	Mark a campaign as finished.
delete_campaign	Delete a campaign.
archive_campaign	Archive a campaign so it drops out of your active list. It keeps its history and is not deleted.
unarchive_campaign	Bring an archived campaign back into the active list.
Mailbox tags
list_email_account_tags	List your email-account tags.
create_email_account_tag	Create a tag for grouping mailboxes.
update_email_account_tag	Rename or recolor a tag.
delete_email_account_tag	Delete a tag (removes it from all mailboxes).
assign_email_account_tags	Tag or untag mailboxes in bulk. Campaigns can then pick sending mailboxes by tag — accounts tagged later join automatically.
Results
get_analytics	Sent, replies, bounces and new-lead numbers over time, by day or week — broken down by campaign, mailbox, tag, sending domain, sequence step or A/B version.
Spam check
check_spam	Score a subject and body for spam-trigger words before you send, with the words it found and how to fix them. Wording only — it does not test inbox placement.
Lead Finder
lead_finder_search	Search the B2B people database. Searching is free; emails stay hidden until you reveal them.
lead_finder_filter_schema	See what you can filter on — job title, seniority, industry, company size, location and more.
lead_finder_suggest_filter_values	Suggest valid values for a filter, e.g. the industries that match “software”.
lead_finder_credits	Check how many Lead Finder credits you have left.
lead_finder_reveal_email	Reveal one person’s verified email. Costs 1 credit; a no-match is never charged, and someone you already own is free.
lead_finder_reveal_emails_bulk	Reveal up to 500 emails in a single call.
lead_finder_reveal_phone	Reveal a mobile number. Costs 10 credits, and the verified email comes along at no extra charge.
lead_finder_build	Run a list build in the background: search, reveal and save the results straight into one of your contact lists.
lead_finder_list_builds	See your list builds and how far along they are.
lead_finder_get_build	Check one build’s status and what it found.
lead_finder_cancel_build	Cancel a build that is still running.

Good to know

Campaigns are always created as drafts. You review them in Automailer and click Launch yourself, or explicitly tell the assistant to launch, and it will double-check with you first.
Multiple workspaces? The assistant works in your main workspace by default. Ask it to “list my workspaces” to see what it can access.
Revoke anytime. Delete the key under Settings → API Keys and the connection stops working immediately.

Troubleshooting

Problem	Fix
Automailer doesn’t show up after adding it	Fully quit and reopen the app. Connectors load at startup.
“Invalid API key” errors	Check the key was pasted completely (they start with amk_live_). If in doubt, create a fresh key in Settings → API Keys and update the URL.
The assistant says it has no Automailer tools	Make sure the connector is enabled for the current chat (check the tools menu in the message box), then start a new chat.
Something else	Email support@automailer.io and include a screenshot of the error.