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
- AutoEmails MCP | Run Email Outreach From Your AI Agent — Connect ChatGPT, Codex, Claude or Cursor to AutoEmails via MCP: find leads, write emails, send tests and go live with bulk sending — you approve every send.
- AutoEmails MCP For Cursor | Setup Guide — Use AutoEmails from Cursor's agent through MCP: build campaigns, read results and send tests from your editor.
- AI Agent Client Email Reports | AutoEmails MCP — Let your AI agent write plain-English client reports from AutoEmails: emails sent, delivery, replies, meetings and revenue for any period.
- How AI Agents Send Email Newsletters With AutoEmails — The exact procedure an AI agent follows to design, target, test and send a marketing newsletter in AutoEmails — the same records and checks as the web app.
- AutoEmails MCP For Claude | Custom Connector Setup — Add AutoEmails to Claude or Claude Code as a remote MCP connector and let Claude run outreach and newsletters with you approving every send.
- Meet Leo, Your AI Email Marketing Agent | AutoEmails — Create newsletters, find prospects and build automations with Leo, your AI email marketing agent. Your brand, your voice, your approval. Start free with AutoEmails.
- How AutoEmails Works — AI Email Marketing Agent Explained — See how the AutoEmails AI agent finds leads, writes personalised emails, launches campaigns and runs automations for you — outreach, marketing and automation in one platform.
- Pricing Plans from Free to Enterprise | AutoEmails — Transparent pricing for every stage of growth. Start free, scale as you grow. No hidden fees, no audience-based billing. Cancel anytime.