How to integrate Bigmailer MCP with Codex

Connect Codex to Bigmailer MCP. Create a new welcome campaign for brand x, list all brands i manage in bigmailer, and more using natural language, with authentication handled for you.

Bigmailer logoBigmailer
Api Key

BigMailer is an email marketing platform for managing multiple brands with white-labeling and automation. It helps teams streamline campaigns and simplify integration with Amazon SES.

57 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With the Bigmailer MCP integration, Codex can manage brands and contacts, create bulk and transactional campaigns, build lists and segments, design templates, and maintain suppression lists, all without leaving the terminal or the app, whichever you prefer.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Bigmailer with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1700+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Bigmailer MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

Try it

Ask Codex for a Bigmailer task. The first time, Composio asks you to connect your Bigmailer account.

For example, ask it to:

  • "Create a new welcome campaign for Brand X"
  • "List all brands I manage in BigMailer"
  • "Get your BigMailer account user details"

What is the Bigmailer MCP server, and what's possible with it?

The Bigmailer MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Bigmailer account. It provides structured and secure access to your email marketing platform, so your agent can perform actions like creating transactional campaigns, retrieving your brands, and managing user account details on your behalf.

  • Automated transactional campaign creation: Have your agent quickly set up new transactional email campaigns for any of your brands, with full control over content, sender details, and subject lines.
  • Brand management and discovery: Let your agent list and organize all brands associated with your Bigmailer account, providing a clear overview for multi-brand operations.
  • User account information retrieval: Easily check your authenticated user details to verify API connectivity and view essential account information in real time.
  • Multi-brand marketing workflow automation: Empower your agent to streamline campaign launches and brand management across multiple business entities from one place.

Conclusion

You've successfully integrated Bigmailer with Codex using Composio's MCP server. Now you can interact with Bigmailer directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Bigmailer operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1700+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Bigmailer operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Bigmailer action and event your agent gets out of the box.

Create Brand

Tool to create a new brand in BigMailer.

Create Brand Property

Tool to create a brand property in BigMailer.

Create Bulk Campaign

Tool to create a bulk email campaign in BigMailer.

Create Contact

Tool to create a new contact in BigMailer within a specified brand.

Create Contact Batch

Upload a batch of 1–1,000 contacts to be created or updated in a BigMailer brand.

Create Field

Tool to create a custom field in a BigMailer brand.

Create List

Creates a new contact list within a specified brand in BigMailer.

Create Segment

Tool to create a segment in BigMailer for a specific brand.

Create Suppression List

Tool to upload a suppression list for a brand in BigMailer.

Create Template

Create an email or page template in a BigMailer brand using HTML for reusable email designs or landing pages, including bulk campaign HTML.

Create Transactional Campaign

Creates a new transactional campaign within a specified brand in BigMailer.

Create User

Tool to create a new user in BigMailer.

Delete Brand Property

Tool to delete a brand property from a brand in BigMailer.

Delete Contact

Delete a contact from a BigMailer brand using its contact ID or email address.

Delete Custom Field

Deletes a custom field from a specified brand in BigMailer.

Delete List

Delete a list from a BigMailer brand without deleting its contacts.

Delete Segment

Tool to delete a segment from a brand in BigMailer.

Delete Template

Tool to delete a template from BigMailer.

Delete User

Delete a BigMailer user by ID and return the ID upon success.

Get Brand

Tool to retrieve detailed information about a specific brand by its ID.

Get Brand Property

Tool to retrieve a specific brand property by its ID for a given brand.

Get Bulk Campaign

Tool to retrieve detailed information about a specific bulk campaign in BigMailer.

Get Contact

Retrieve a specific contact from a BigMailer brand by contact ID or email, including email, custom field values, list memberships, unsubscribe status, and bounce and complaint counts.

Get Contact Batch Status

Tool to retrieve the status and results of a contact batch upload in BigMailer.

Get Custom Field

Tool to retrieve a custom field from a BigMailer brand.

Get List

Tool to retrieve details of a specific list within a brand.

Get Segment

Tool to retrieve a specific segment from BigMailer by brand ID and segment ID.

Get Suppression List

Tool to retrieve details of a specific suppression list for a brand in BigMailer.

Get Template

Tool to retrieve detailed information about a specific template by its ID.

Get Transactional Campaign

Tool to retrieve detailed information about a specific transactional campaign in BigMailer.

Get User

Retrieve a BigMailer user by ID to inspect their email, role, activation status, and available brand permissions.

Get User Information

This tool retrieves information about the authenticated user in BigMailer using the GET /me endpoint.

List All Brands

List a page of brands associated with the authenticated BigMailer account via GET /brands.

List Brand Properties

Tool to retrieve a list of brand properties for a specific brand in BigMailer.

List Bulk Campaigns

Tool to list bulk campaigns for a specified brand in BigMailer.

List Connections

Tool to list all connections in your BigMailer account.

List Contacts

Tool to list contacts for a brand in BigMailer.

List Fields

List a page of custom fields for a specific BigMailer brand, including field names, types, and merge tags.

List Contact Lists

Tool to retrieve all contact lists for a specified brand in BigMailer.

List Message Types

Tool to list message types for a specific brand in BigMailer.

List Segments

List segments for a specific brand in BigMailer, returning one page with pagination information.

List Senders

List a page of sender identities associated with a specific BigMailer brand, including verification status and any available DNS configuration details.

List Suppression Lists

List suppression lists for a specific brand, with pagination via cursor and limit parameters.

List Templates

Lists a page of templates for a specified BigMailer brand, including email and page templates.

List Transactional Campaigns

Tool to list transactional campaigns for a specified brand in BigMailer.

List Users

List users in your BigMailer account to retrieve user information and review account access or permissions.

Update Brand

Tool to update a brand in BigMailer.

Update Brand Property

Tool to update a brand property in BigMailer.

Update Bulk Campaign

Update an existing BigMailer bulk campaign's name, subject, content, recipients, scheduling, or tracking settings.

Update Contact

Update an existing BigMailer contact's details, field values, list memberships, and unsubscribe settings.

Update Field

Tool to update a custom field in BigMailer.

Update List

Tool to update a list in BigMailer.

Update Segment

Tool to update an existing segment in BigMailer.

Update Template

Tool to update an existing email or page template in BigMailer.

Update Transactional Campaign

Tool to update a transactional campaign in BigMailer.

Update User

Tool to update a user in BigMailer.

Upsert Contact

Tool to create or update a contact in a BigMailer brand.

FAQ

Frequently asked questions

Start with Bigmailer.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Bigmailer tool your agent needs.Free to start.

Start building