Skip to content

Run email marketing from Codex.

Paste one line. It writes the MCP config, opens the browser sign-in, and starts working. No token in config.toml.

Paste this into Codex
Read lumail.io/codex/install and set up the Lumail connection for me.
See the manual setup
codex
codex mcp login lumail
Opening browser · signed in · org: Acme
lumail · https://lumail.io/mcp · connected
How did last week's newsletter perform?
3,412 delivered · 44.8% opens · 6.1% clicks

Setup

  1. 1. Declare the server

    [mcp_servers.lumail]
url = "https://lumail.io/mcp"
oauth_resource = "https://lumail.io/mcp"

  2. 2. Sign in through your browser

    codex mcp login lumail

  3. 3. Verify, then start a new session

    codex mcp list
See the CLI setup

Questions

What is the Lumail plugin for Codex?

It is an OAuth MCP connection to your Lumail organization, packaged as a Codex plugin with two skills. Once connected, Codex can read subscribers, campaigns, tags, workflows and analytics, and create drafts.

Do I need an API token?

No. Codex registers itself with Lumail through dynamic client registration and runs the browser OAuth flow. config.toml contains only the server URL, so there is nothing sensitive to protect or rotate.

How do I install it?

Paste 'Read lumail.io/codex/install and set up the Lumail connection for me.' into Codex and it does the setup. Manually: add the mcp_servers.lumail block to ~/.codex/config.toml, then run codex mcp login lumail.

I already had Lumail set up with an API token. What changes?

Remove the bearer_token_env_var line from your mcp_servers.lumail block and add oauth_resource, then run codex mcp login lumail. A leftover bearer token shadows the OAuth credential and keeps you on the old endpoint.

Does it work in the Codex app as well as the CLI?

Yes. Both surfaces read the same MCP configuration and the same stored authorization, so the Lumail tools appear wherever Codex runs on your machine.

Can Codex send a campaign?

Not over this connection. Send, schedule, publish, unsubscribe and delete tools are not registered on the OAuth endpoint, so the agent never sees them. Sending happens in the Lumail app, or through the Lumail CLI.

Do I need a paid plan?

No. The free plan includes MCP access with 100 requests per minute. Premium raises it to 700 and Business to 2,000, counted per organization.

How do I revoke access?

Disconnect the app from your Lumail settings, which cuts access immediately, or delete the mcp_servers.lumail block from config.toml to remove it locally.