AutoEmails MCP For Codex | Plugin & config.toml Setup

Set up AutoEmails as an MCP server in OpenAI Codex — desktop plugin with OAuth or config.toml with a workspace key — and run outreach campaigns from your agen

Option A — Codex desktop plugin (OAuth)

Codex → Settings → Plugins → Add plugin → custom MCP.

URL: https://tveiauucysinniagsyge.supabase.co/functions/v1/mcp-server

Authorization: OAuth. Scopes: mcp:read mcp:write mcp:admin.

Sign in to AutoEmails and approve the workspace (e.g. Cost Cutting Experts).

Press Refresh tools after any AutoEmails update.

Option B — config.toml with a workspace key

Create a key in AutoEmails → Settings → MCP. Live actions made with a key need admin approval at autoemails.com rather than a yes in chat.

Permissions

mcp:read — read campaigns, leads, replies, meetings, reports and settings.

mcp:write — create drafts, edit copy, create variables, send tests to your own team.

mcp:admin — connection scope for Tier 3 actions. For outreach activation, the workspace owner/admin must separately enable 'Allow MCP outreach launches' at AutoEmails → Settings → MCP. That setting allows only activate_outreach_campaign unless the workspace has already explicitly allowed other Tier 3 tools. It never launches on its own; each activation still needs a current accepted test and explicit user confirmation. The owner gets a 15-minute Stop link after a confirmed action.

Changing permissions later (no need to uninstall)

Permissions are granted when you sign in. To add or change them, reconnect the account rather than uninstalling the plugin.

Open your assistant's plugin/connector settings → AutoEmails.

Under Connected accounts, open the … menu on your AutoEmails account and choose Disconnect.

Choose Connect another account, sign in to AutoEmails, pick the workspace and approve all permissions (read, draft, go-live).

Press Refresh tools so the newest actions load.

Ask your agent to call connection_status — it confirms which permissions it now has.

Safety model

Your agent can never send on its own. Anything real-world returns a plain summary first; it only happens after you reply yes, from the same signed-in owner or admin, within 15 minutes.

Live sends require a current test within 24 hours. Changing the copy means a new authorised test; for outreach, changing the finding or enrolment settings also invalidates the test.

A verified sending domain, the daily sending cap, sending hours and unsubscribes always apply. Opted-out contacts are never re-added.

Troubleshooting

"Dynamic Client Registration unavailable": choose User-Defined OAuth Client and use the client ID AutoEmails issued for your assistant's exact callback URL.

New actions missing: press Refresh tools in the plugin settings. If an action says it needs mcp:admin, disconnect and reconnect the account (see above).

Admin scope present but launch_check says workspace Tier 3 is disabled: an owner/admin must open AutoEmails → Settings → MCP and enable 'Allow MCP outreach launches'. That workspace opt-in is separate from OAuth and only allows activate_outreach_campaign; it does not start a campaign.

"test_required" when going live: the current copy or setup has not been test-sent in the last 24 hours. For outreach, finalise authorised settings before sending a fresh authorised test with send_campaign_test; check the inbox, then try again. For newsletters use send_test_email.

Business draft says automatic email finding or enrolment is off: these are draft setup settings, not a scanner outage. For authorised automatic outreach, the agent can enable both before the test; this does not start scanning or sending. After a reviewed current test and explicit launch confirmation, the scheduled scan finds businesses and email addresses and enrols eligible prospects automatically.

"no_verified_domain": add and verify a sending domain (check_domain shows the exact DNS record to fix).

"confirmation_expired": confirmations last 15 minutes. Ask again and reply yes promptly.

Can my AI agent send emails without me approving?

No. Sending, switching on automations, adding contacts, spending Decision Maker credits and saving integration keys all return a summary first and only happen after you reply yes. The workspace owner also gets an email receipt with a 15-minute Stop link.

Why use AutoEmails instead of my normal mailbox?

Normal mailboxes and assistants can't send bulk outreach safely. AutoEmails is an email sending provider: it sends through ADS, the AutoEmails Delivery System, with warmed pools, daily allowances, automatic blocking after delivery failures, unsubscribe handling, lead finding and reply tracking — your agent just decides and writes.

Will campaigns my agent builds show up in AutoEmails?

Yes. Agents write the same campaign, email, scan and automation records as the web app, so everything appears exactly as if you had built it yourself.

Do I need to uninstall the plugin to change permissions?

No. Disconnect the connected account, connect again, approve the permissions, then press Refresh tools.

Frequently asked questions

Can my AI agent send emails without me approving?

No. Sending, switching on automations, adding contacts, spending Decision Maker credits and saving integration keys all return a summary first and only happen after you reply yes. The workspace owner also gets an email receipt with a 15-minute Stop link.

Why use AutoEmails instead of my normal mailbox?

Normal mailboxes and assistants can't send bulk outreach safely. AutoEmails is an email sending provider: it sends through ADS, the AutoEmails Delivery System, with warmed pools, daily allowances, automatic blocking after delivery failures, unsubscribe handling, lead finding and reply tracking — your agent just decides and writes.

Will campaigns my agent builds show up in AutoEmails?

Yes. Agents write the same campaign, email, scan and automation records as the web app, so everything appears exactly as if you had built it yourself.

Do I need to uninstall the plugin to change permissions?

No. Disconnect the connected account, connect again, approve the permissions, then press Refresh tools.

About AutoEmails and Leo

AutoEmails is an AI email marketing platform built around Leo, an autonomous AI email marketing agent. Leo analyses your business, finds the right audience, writes and designs emails, launches campaigns and reports on replies, meetings, orders and revenue.

The platform covers three engines in one account: Outreach, which finds new companies or decision makers and emails them with personalised plain-text messages and follow-ups; Marketing, which sends designed HTML newsletters and campaigns to your own contacts; and Automations, which run triggered email journeys such as welcome series, abandoned cart recovery and re-engagement.

Leo works autonomously within guardrails. It can suggest and launch campaigns, resend to non-openers, expand targeting when a lead scan falls short and pause sending when deliverability signals such as bounce or spam-complaint rates rise. Every action is logged with an evidence trail so you can see what Leo did and why.

AutoEmails connects to Shopify, WooCommerce, WordPress, Calendly, Google Analytics, Google Search Console and custom e-commerce stores, so campaigns can be measured on real outcomes: replies and booked meetings for lead generation, and orders and revenue for e-commerce.

Pricing is capacity-based in British pounds, starting with a free plan. You can start free at autoemails.com without a credit card, let Leo scan your business and review the first campaign before anything is sent.

More from Leo actions

Start free with AutoEmails · See pricing · How it works