How to integrate Brevo MCP with Codex

Connect Codex to Brevo MCP. Send sms campaign to new subscribers, create or update an email template, and more using natural language, with authentication handled for you.

Brevo logoBrevo
Api KeyOauth2

Brevo is an all-in-one email and SMS marketing platform for transactional messaging, automation, and CRM. It helps businesses engage customers and streamline communications through powerful campaign tools.

62 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With the Brevo MCP integration, Codex can send transactional emails, create and send email and SMS campaigns, manage contacts and lists, and track deals, 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 Brevo 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 Brevo 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 Brevo task. The first time, Composio asks you to connect your Brevo account.

For example, ask it to:

  • "Send SMS campaign to new subscribers"
  • "Create or update an email template"
  • "Find contact details by email address"

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

The Brevo MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Brevo account. It provides structured and secure access to your contacts, campaigns, templates, transactional email activity, SMS campaigns, and CRM records, so your agent can manage contacts, create campaigns, send emails, review messaging activity, and maintain company records on your behalf.

  • Contact and audience management: Have your agent create, update, delete, import, and review contacts, organize them into lists, and inspect configured contact attributes.
  • Email campaign creation and delivery: Direct your agent to create or update email campaigns, review campaign details, and send completed draft campaigns to their recipients.
  • Transactional email and templates: Let the agent create or update email templates, send or schedule transactional emails, and review transactional email events.
  • SMS campaign management: Instruct your agent to create SMS campaigns, review existing campaigns and their details, or delete campaigns that are no longer needed.
  • CRM and performance insights: Have your agent create, review, list, or delete companies, check contact campaign statistics, and inspect sender domains and their verification status.

Conclusion

You've successfully integrated Brevo with Codex using Composio's MCP server. Now you can interact with Brevo 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 Brevo 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 Brevo operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

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

Add Contacts to List

Add existing Brevo contacts to one list using one identifier family.

Create a company

Creates a new company record in your Brevo CRM.

Create Contact

Create a Brevo contact, or update a matching contact when explicitly enabled.

Create Contact Attribute

Create a Brevo contact attribute definition.

Create Contact List

Creates a new contact list (audience) in Brevo within a specified folder.

Create Deal

Create a Brevo CRM deal with optional attributes and associations.

Create Email Campaign

Create an email campaign as a draft, or schedule it when requested.

Create or Update Email Template

This tool creates a new email template or updates an existing one in Brevo.

Create Sender

Create a Brevo email sender identity and return DNS configuration warnings.

Create Sender Domain

Register a Brevo sender domain and return available DNS authentication records.

Create SMS Campaign

This tool allows you to create a new SMS campaign in Brevo.

Delete a company

Deletes a company from Brevo using its unique identifier.

Delete Contact

Deletes a contact from Brevo by email, contact ID, external ID, phone number, WhatsApp ID, or landline number.

Delete Contact List

Permanently delete a Brevo contact list without deleting its contacts.

Delete Email Campaign

Delete an unscheduled campaign and related template, builder, and schedule data.

Delete Email Template

This tool deletes an inactive email template from Brevo.

Delete SMS Campaign

This tool deletes an existing SMS campaign.

Export Email Campaign Recipients

Start an asynchronous CSV export of a sent email campaign's recipients.

Get Account Information

Retrieves comprehensive information about the authenticated Brevo account.

Get Aggregated Transactional Email Report

Return aggregate delivery and engagement totals for transactional emails.

Get all contacts

Retrieves a page of Brevo contacts, with filters for creation or modification dates, list IDs, or a segment ID.

Get all email templates

This tool retrieves a list of all email templates created in your Brevo account.

Get All Senders

This tool retrieves a list of all senders associated with the Brevo account.

Get Company Details

Retrieves detailed information about a specific company from Brevo's CRM.

Get Contact Campaign Stats

Retrieve a contact's email campaign statistics for a bounded date range.

Get Contact Details

This tool retrieves detailed information about a specific contact in Brevo.

Get Contact List

Get contact-list metadata and optional campaign statistics by list ID.

Get contact lists

Retrieve one page of Brevo contact lists, including list IDs and names and, when returned, subscriber counts and folder associations.

Get Email Campaign Details

Retrieve details for a specific email campaign, including available HTML content, recipients, and statistics.

Get Email Template

Retrieve one transactional email template by numeric or custom ID.

Get Process

Retrieve the status and available result details of a Brevo process.

Get SMS Campaign Details

Retrieves the details of a specific SMS campaign.

Get SMS Campaigns

List a page of Brevo SMS campaigns, with optional status and sent-date filtering, pagination, and creation-date sorting.

Get Transactional Email

Retrieve a sent transactional email by its identifier, including event history and personalized content when retained by Brevo.

Import Contacts

Submit a contact import to Brevo and return its background process ID.

List All Companies

This action retrieves a list of all companies stored in the Brevo CRM.

List Contact Attributes

List the contact attributes configured in the Brevo account.

List Contact Folders

List folders that organize contact lists in the connected Brevo account.

List Contact Lists in Folder

List one bounded page of contact lists belonging to a Brevo folder.

List Contact Segments

List one page of contact segments configured in the Brevo account.

List CRM Notes

List one page of Brevo CRM notes, optionally filtered by entity and date.

List CRM Pipelines

List every Brevo CRM deal pipeline with its stages and stage settings.

List Custom Object Records

List one page of records for an Enterprise-only Brevo custom object.

List Deals

List one page of Brevo CRM deals with optional relationship filters.

List Email Campaigns

List a page of Brevo email campaigns, with filters for type, status, and dates.

List Orders

List one page of Brevo ecommerce orders.

List Organization Users

List active and pending users in the connected Brevo organization.

List Processes

List a bounded page of Brevo background processes for status monitoring.

List Sender Domains

List sender domains and their authentication and verification status.

List Transactional Email Events

List one page of transactional email events with Brevo's complete filter set.

List Transactional Emails

List a page of sent transactional email records, filtered by recipient email, template ID, or message ID.

Remove Contacts from List

Remove selected contacts, or every contact, from one Brevo list.

Send Email Campaign Now

Request immediate sending of an existing draft email campaign to its recipients.

Send Email Campaign Test

Send a campaign test to explicit recipients or the account test list.

Send Transactional Email

Send or schedule one or many transactional emails through Brevo.

Send Transactional Template Test

Send a transactional template test to recipients or the account test list.

Update Contact

Update fields and list memberships for an existing Brevo contact.

Update Contact List

Rename an existing Brevo contact list, move it to a folder, or both.

Update Deal

Update a Brevo CRM deal's fields or complete association lists.

Update Email Campaign

Updates an email campaign in Brevo using its unique identifier.

Update Email Campaign Status

Apply a documented lifecycle status operation to an email campaign.

Upload Campaign Image

Upload an image from a public URL to Brevo's campaign image gallery.

FAQ

Frequently asked questions

Start with Brevo.It takes 30 seconds.

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

Start building