Connect AI tools to nexmail with MCP
Connect Claude, ChatGPT, Codex, Grok or another MCP client to nexmail, then plan emails, attach images and review designs from your AI tool.
MCP (Model Context Protocol) lets an AI tool work with your nexmail account directly. Once connected, you can ask it to write briefs, attach products and images, show you designs, and read your email performance.
What you need
- A nexmail account. Sign up free.
- An AI tool that supports remote MCP servers.
Every connection uses this server address:
https://api.nexmail.ai/api/mcp/mcp
Choose how to connect
- Sign in with your nexmail account (OAuth): best for tools with a connector screen, such as Claude and ChatGPT. You sign in with your email and password or with Google, then choose which organization to connect.
- Use an API key: best for tools you configure with a file or command, such as Claude Code and Codex.
Either way, the tool can act on your behalf in that organization, so only connect tools you trust.
Create an API key
Skip this if you are signing in with OAuth.
- In nexmail, open Settings > Organization > MCP/API. If you are not an organization owner, open Settings > MCP/API.
- Click New Key and give it a name.
- Select Agents & MCP clients. A key without this option cannot connect over MCP.
- Create the key and copy it. It is only shown once.
The same page then shows setup instructions for each tool.
Connect your tool
Claude (Connectors)
On plans that support connectors, open Customize > Connectors (Settings > Connectors on some versions), click Add, then Add custom connector, and paste the server address. Click Connect and sign in to nexmail. On Team and Enterprise plans, an admin may need to add it first under Organization settings > Connectors.
Turn nexmail on in each chat where you want to use it.
Claude Code
Run this in your terminal, using your API key:
claude mcp add --transport http nexmail https://api.nexmail.ai/api/mcp/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
Claude Desktop with an API key
Add this to claude_desktop_config.json, then restart the app:
{
"mcpServers": {
"nexmail": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.nexmail.ai/api/mcp/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
}
}
}
Codex
Add this to ~/.codex/config.toml:
[mcp_servers.nexmail]
url = "https://api.nexmail.ai/api/mcp/mcp"
http_headers = { "Authorization" = "Bearer YOUR_API_KEY" }
ChatGPT
This needs a paid ChatGPT plan, and on workspaces an admin has to enable developer mode first.
- Open Settings > Apps > Advanced settings and turn on Developer mode.
- Add a custom connector and paste the server address.
- Sign in to nexmail when prompted.
Grok and other tools
Grok supports remote MCP servers through the xAI API. Add nexmail as a remote server using the server address, and send your API key as a bearer token in the Authorization header. For any other tool, look for its remote MCP or custom connector settings and use the same details.
nexmail has many tools, so if your client lets you choose, load only the ones you need.
Start using it
Ask your AI tool to list your brands, then try one of these:
- "Write a brief for a new arrivals email next Tuesday."
- "What is waiting on me for this brand?"
- "Show me the latest design and how many revision rounds are left."
- "Change the headline on this design to Free shipping this week."
- "Add these products to the brief, and remove the old image."
- "Save this brief for December 1 without starting production."
- "How did last month's campaigns perform?"
Brief writing, direct edits and design review are for brands on White Glove. Reading emails and performance works for other brands too.
nexmail will not approve a design or send anything unless you ask, and your AI tool may ask you to confirm first.
Add your own images to a brief
You can attach images made in another tool, such as an AI image generator.
- Ask your AI tool to import the image into your nexmail media library. The image needs a public web address and must be a JPEG, PNG, WebP or GIF of up to 100 MB. nexmail keeps its own copy, so the original link only has to work during the import.
- Ask it to attach the imported image when it writes or updates the brief.
If your tool can make images but cannot connect to nexmail, upload them to your media library yourself, then ask your connected tool to attach them.
Change a design directly
For a small change, your AI tool can edit the design without using a revision round. It can change text, text color, size, weight and alignment, and swap images. For layout changes, ask it to request changes from the team instead.
If the email was already exported, a draft updates automatically. A scheduled email or exported template does not, so export it again.
Troubleshooting
A new tool does not show up. Start a new chat. If it still does not appear, disconnect and reconnect nexmail.
The connection is refused with an API key. Check that the key is still active and that it was created with Agents & MCP clients selected.
Google sign-in says no account uses this email. Sign in with the email on your nexmail account, or create an account first.
The sign-in page names a tool you do not recognize. Close the page. Only continue if you started the connection yourself.
An image will not import. Check that the link opens without a login and points directly to an image file, not a web page.
Disconnect a tool
To remove API key access, go back to MCP/API and revoke the key. To remove a connector, delete it in your AI tool's settings.