Integration Guide

Learn how to integrate Brevo MCP to popular MCP clients.

Claude Configuration (via JSON)

Follow the steps below to configure the client for communication with Brevo MCP server:

  1. Download Claude Desktop to your system
  2. After opening Claude desktop, you can edit configuration under Settings > Developer > Edit Config .
  3. Add to your Claude configuration file:
{
  "mcpServers": {
    "brevo_contacts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo_contacts/mcp/YOUR_MCP_TOKEN"
      ]
    },
    "brevo_deals": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo_deals/mcp/YOUR_MCP_TOKEN"
      ]
    },
    "brevo_campaigns": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp/YOUR_MCP_TOKEN"
      ]
    }
  }
}

Configuration panel in Claude 0.10

Configuration Panel in Claude 0.10


Claude Configuration (using connectors)

  1. Download Claude Desktop to your system.
  2. After opening Claude desktop, you can edit configuration under Settings > Connectors > Organization connectors .
  3. Click on Add custom connector
  4. Add "Brevo connector" under name.
  5. Add the remote MCP url : https://mcp.brevo.com/v1/brevo_contacts/mcp/YOUR_MCP_TOKEN"

Custom connector configuration window

Custom connector configuration window




Cursor

Follow the steps below to configure Cursor for communication with Brevo MCP server:

  1. Download and install Cursor
  2. Go to: Settings > Developer > Edit Config (or wherever your configuration file for MCP clients is stored — typically this is under your workspace config or in a .cursor_mcp_settings.json file at the root of your project).
  3. Add the following configuration (replacing YOUR_MCP_TOKEN with your actual token):
{
  "mcpServers": {
    "brevo_contacts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo_contacts/mcp/YOUR_MCP_TOKEN"
      ]
    },
    "brevo_deals": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo_deals/mcp/YOUR_MCP_TOKEN"
      ]
    },
    "brevo_campaigns": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp/YOUR_MCP_TOKEN"
      ]
    }
  }
}
MCP Tools Configuration Panel in Cursor

MCP Tools Configuration Panel in Cursor


Cline/VSCode

Configuration for VSCode in .cline_mcp_settings.json:

{
  "mcpServers": {
    "brevo_complete": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo/mcp/YOUR_MCP_TOKEN"
      ]
    }
  }
}


Custom Implementation

For custom MCP clients:

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';

const transport = new SSEClientTransport(
  new URL('https://mcp.brevo.com/v1/brevo_contacts/mcp/YOUR_MCP_TOKEN')
);

const client = new Client(
  {
    name: "brevo-client",
    version: "1.0.0"
  },
  {
    capabilities: {}
  }
);

await client.connect(transport);


Service-Specific Tool Examples

Tools from different Brevo categories are mentioned as follows:

Contact Management

ToolDescriptionUse Case
get_contactsList contacts with filteringContact discovery and analysis
get_contact_infoDetailed contact informationCustomer service and support
create_contactAdd new contactsLead capture and onboarding
update_contactModify contact dataData maintenance and enrichment
delete_contactRemove contactsData cleanup and compliance

Deal Management

ToolDescriptionUse Case
get_dealsList deals with filteringSales pipeline analysis
get_dealDetailed deal informationDeal review and updates
create_dealAdd new opportunitiesLead qualification and tracking
update_dealModify deal propertiesPipeline progression
delete_dealRemove dealsData cleanup

Email Campaign Management

ToolDescriptionUse Case
create_email_campaignCreate marketing campaignsCampaign launches
get_email_campaignsList campaigns with statsPerformance monitoring
send_email_campaign_nowSend campaigns immediatelyCampaign execution
send_test_email_campaignTest before sendingQuality assurance
get_campaign_detailsDetailed campaign analyticsPerformance analysis

Analytics

ToolDescriptionUse Case
get_email_campaign_statisticsDetailed email metricsPerformance evaluation
get_sms_campaign_statisticsSMS campaign analyticsMulti-channel analysis
get_account_sending_statisticsAccount-wide metricsExecutive reporting
get_campaign_comparison_analyticsA/B testing analysisOptimization insights

Example Usage

# Through MCP-enabled AI assistant
prompt = """
Using the Brevo contacts tool, please:
1. Get all contacts from France
2. Show contacts created in the last week
3. Create a new contact for [email protected] with name "John Doe"
"""


What’s Next