What is Model Context Protocol (MCP)?

The Model Context Protocol feature is currently available in early access to some users. To learn more, check our developer documentation.

Model Context Protocol (MCP) is a revolutionary technology that allows AI assistants like Claude, ChatGPT, and other AI tools to directly connect to your Brevo account. The AI can see and interact with your Brevo data, like your email campaigns, contacts, or sales deals, in real time during your conversation. With more than 26 specialized MCP services already available, you can manage your entire Brevo ecosystem through AI conversation:

  • Complete CRM and sales pipeline management.
  • Full-featured email, SMS, and WhatsApp marketing.
  • Advanced analytics and performance tracking.
  • Account and team management.
  • Technical infrastructure and deliverability tools.

Why use Brevo MCP?

Brevo MCP offers a seamless AI-powered workflow, allows you to access data in real-time, and uses natural language.

  • Seamless AI-Powered Workflow
    Instead of switching between your AI assistant and Brevo dashboard, you can now:
    • Ask your AI to check campaign performance directly.
    • Get contact information without leaving your chat.
    • Create and manage deals through natural conversation.
    • Analyze your marketing data with AI insights.
    • Manage your entire CRM and marketing stack conversationally.
  • Real-time data access
    Your AI assistant gets live access to your Brevo data, meaning you always get the most current information about your campaigns, contacts, and business metrics.
  • Natural language control
    You can use simple questions in natural language like: "Show me my top-performing email campaigns this month" or "Create a new deal for Acme Corp worth $5,000".

Connect your AI with Brevo

💡 Good to know
For the configuration steps performed in your AI assistant, check the documentation of your AI assistant for detailed instructions.

You need to create your MCP API key and connect and configure your AI with Brevo using the MCP.

Step 1: Create your MCP API key

  1. From Brevo, click the account dropdown and select SMTP & API > API Keys & MCP.
  2. Click Generate a new API key.
  3. Name your API key. Make sure it specifies which AI assistant the MCP API key will be used with, so you can easily recognize it.
  4. Click Generate.
  5. Activate the Create MCP server API key option to generate a version of the API key allowing you to connect an AI system to Brevo via the MCP protocol.
    mcp_create-mcp-token_en-us.png
  6. Copy your MCP API key and store it in a safe environment.

    ❗️ Important
    Your MCP API key is only visible during this step. Once your MCP API key is created, you won't be able to copy it anymore and you'll need to create a new one if you lose it.
  7. Click OK.

Step 2: Connect and configure your AI assistant

You can now connect and configure your AI assistant:

  1. Connect to specific Brevo services you need by adding the following code to the configuration file of your AI, where "YOUR_TOKEN" is the MCP API key you created and copied in step 1:
    • Deals management

      {
         "mcpServers": {
            "brevo_deals": {
               "command": "npx",
               "args": [
                  "-y",
                  "mcp-remote",
                  "https://mcp.brevo.com/v1/brevo_deals/mcp/YOUR_TOKEN"
               ]
            }
         }
      }
    • Contact management

      {
         "mcpServers": {
            "brevo_contacts": {
               "command": "npx",
               "args": [
                  "-y",
                  "mcp-remote",
                  "https://mcp.brevo.com/v1/brevo_contacts/mcp/YOUR_TOKEN"
               ]
            }
         }
      }
    • Email campaigns

      {
         "mcpServers": {
            "brevo_email_campaigns": {
               "command": "npx",
               "args": [
                  "-y",
                  "mcp-remote",
                  "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp/YOUR_TOKEN"
               ]
            }
         }
      }
    • [Advanced] Connect to all services

      {
         "mcpServers": {
            "brevo_all": {
               "command": "npx",
               "args": [
                  "-y",
                  "mcp-remote",
                  "https://mcp.brevo.com/v1/brevo/mcp/YOUR_TOKEN"
               ]
            }
         }
      }
  2. Configure your AI assistant:
    • For Claude Desktop: add the configuration to your Claude configuration file and restart Claude Desktop. Brevo tools will then be available in your chat.
    • For other AI assistants: check the documentation of your AI assistant for MCP server configuration.

What services are available?

Your Brevo MCP integration provides access to your entire Brevo ecosystem through natural conversation. The following powerful services are available:

Contact and customer management
  • Contacts (brevo_contacts): manage your complete contact database, add new contacts, update information, and organize your customer relationships.
  • Contact attributes (brevo_attributes): create and manage custom fields for contacts (like "industry," "company size," or "lead score").
  • Lists (brevo_lists): organize contacts into targeted groups for campaigns (newsletters, VIP customers, prospects).
  • Segments (brevo_segments): create smart, automatically-updating contact groups based on behavior and attributes.
  • Folders (brevo_folders): structure and organize your contact lists for better management.
  • Contact import/export (brevo_contact_import_export): handle bulk contact operations, data migration, and backups.
CRM and sales management
  • Companies (brevo_companies): manage business accounts, track company information, and maintain B2B relationships.
  • Deals (brevo_deals): track sales opportunities, manage your pipeline, and close more business.
  • Pipelines (brevo_pipelines): configure and customize your sales process stages and workflows.
  • Tasks (brevo_tasks): create follow-ups, schedule calls, set reminders, and manage your daily activities.
  • Notes (brevo_notes): add communication history, meeting notes, and important context to contacts and deals.
Email marketing
  • Email campaigns (brevo_email_campaign_management): create, send, and manage marketing email campaigns.
  • Email templates (brevo_templates): design reusable email templates for consistent branding.
  • Transactional email templates (brevo_transac_templates): set up automated emails like receipts, confirmations, and notifications.
  • Senders (brevo_senders): manage your sender identities and email addresses.
  • External feeds (brevo_external_feeds): integrate dynamic content from external sources into your emails.
Multi-channel communication
  • SMS campaigns (brevo_sms_campaigns): create and send SMS marketing messages.
  • WhatsApp campaigns (brevo_whatsapp_campaigns): send business messages through WhatsApp.
  • WhatsApp templates: manage approved WhatsApp message templates for compliance.
Analytics and performance
  • Campaign analytics (brevo_campaign_analytics): deep-dive into email, SMS, and WhatsApp campaign performance.
  • Real-time metrics: get live campaign statistics and engagement data.
  • Comparison tools: A/B test results and campaign performance comparisons.
  • Account statistics: overall sending performance and deliverability metrics.
Account and team management
  • Account management (brevo_accounts): handle main account settings and sub-account creation.
  • Users (brevo_users): manage team members and their permissions.
  • Groups (brevo_groups): organize sub-accounts for agencies and enterprises.
Technical infrastructure
  • Domains (brevo_domains): configure and verify sending domains for better deliverability.
  • IP management (brevo_ips): manage dedicated IP addresses for high-volume sending.
  • Process monitoring (brevo_processes): track background operations like imports and exports.
System operations
  • Background processes: monitor imports, exports, and other long-running operations.
  • Bulk operations: handle large-scale data management and migrations.
  • System health: check service status and performance metrics.

Service connection examples

We have compiled a list of a few service connection examples:

  • For CRM focus (contacts, deals, tasks):

    {
       "mcpServers": {
          "brevo_contacts": {
             "command": "npx",
             "args": ["-y", "mcp-remote", "https://mcp.brevo.com/v1/brevo_contacts/mcp/YOUR_TOKEN"]
          },
          "brevo_deals": {
             "command": "npx",
             "args": ["-y", "mcp-remote", "https://mcp.brevo.com/v1/brevo_deals/mcp/YOUR_TOKEN"]
          },
          "brevo_tasks": {
             "command": "npx",
             "args": ["-y", "mcp-remote", "https://mcp.brevo.com/v1/brevo_tasks/mcp/YOUR_TOKEN"]
          }
       }
    }
  • For email marketing focus (campaigns, templates, analytics):

    {
       "mcpServers": {
          "brevo_campaigns": {
             "command": "npx",
             "args": ["-y", "mcp-remote", "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp/YOUR_TOKEN"]
          },
          "brevo_templates": {
             "command": "npx",
             "args": ["-y", "mcp-remote", "https://mcp.brevo.com/v1/brevo_templates/mcp/YOUR_TOKEN"]
          },
          "brevo_analytics": {
             "command": "npx",
             "args": ["-y", "mcp-remote", "https://mcp.brevo.com/v1/brevo_campaign_analytics/mcp/YOUR_TOKEN"]
          }
       }
    }
    
  • For multi-channel marketing (email, SMS, WhatsApp):

    {
       "mcpServers": {
          "brevo_email": {
             "command": "npx",
             "args": ["-y", "mcp-remote", "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp/YOUR_TOKEN"]
          },
          "brevo_sms": {
             "command": "npx",
             "args": ["-y", "mcp-remote", "https://mcp.brevo.com/v1/brevo_sms_campaigns/mcp/YOUR_TOKEN"]
          },
          "brevo_whatsapp": {
             "command": "npx",
             "args": ["-y", "mcp-remote", "https://mcp.brevo.com/v1/brevo_whatsapp_campaigns/mcp/YOUR_TOKEN"]
          }
       }
    }

Common use cases

💡 Good to know
To successfully use the Model Context Protocol, we recommend starting small. Focus on one specific service with basic operations to become familiar with the integration. Use natural language rather than technical commands. Always keep your MCP API key secure and never share it with anyone.

We've gathered a list of common use cases that you may need. The following table gives a few examples of request you can make, by use case.

Use case

Examples of requests

Daily CRM and sales management
  • "Show me my tasks for today"
  • "Create a deal for the new client inquiry worth $10,000"
Contact and database management
  • "Add these new contacts to my VIP list"
  • "Show me all contacts from the tech industry"
Email marketing operations
  • "Send a test of my holiday campaign to the marketing team"
  • "How many people opened yesterday's newsletter?"
Multi-channel campaign management
  • "Create an SMS campaign for our flash sale"
  • "Send a WhatsApp message to VIP customers about the event"
Analytics and performance tracking
  • "Compare my last three email campaign performances"
  • "Show me SMS campaign results from this week"
Team and account management
  • "Show me all users in our account"
  • "Create a new sub-account for our client"
Advanced operations
  • "Check the status of my contact import process"
  • "Verify my sending domain configuration"

Troubleshooting

Expand the accordions corresponding to the most common issues you may encounter and view how to solve them.

Connection issues
  • Verify your MCP API key is correct and active.
  • Check that you copied the token properly from your Brevo account.
  • Ensure your AI assistant supports MCP.
Data is not showing
  • Confirm you're connected to the right Brevo service.
  • Check your Brevo account permissions.
  • Verify your MCP API key is still valid.
  • Try refreshing your AI assistant.
Performance issues
  • Use specific service connections instead of all services.
  • Start with simple queries before complex operations.

Upcoming enhancements

Brevo is continuously expanding MCP capabilities. We're working to make MCP API keys even more accessible and easier to manage directly from your Brevo API Management dashboard.

  • Enhanced integration: deeper AI workflow automation.
  • Improved analytics: more sophisticated reporting and insights.
  • Advanced personalization: AI-powered content recommendations.
  • Extended multi-channel: additional communication channels and platforms.
  • Smart automation: intelligent campaign optimization and A/B testing.

 

🤔 Have a question?

If you have a question, feel free to contact our support team by creating a ticket from your account. If you don't have an account yet, you can contact us here.

If you’re looking for help with a project using Brevo, we can match you with the right certified Brevo Agency partner.

💬 Was this article helpful?

4 out of 6 found this helpful