Integration guide | Brevo API Documentation

Claude Configuration (via JSON)

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

Download Claude Desktop to your system
After opening Claude desktop, you can edit configuration under Settings > Developer > Edit Config.
Add to your Claude configuration file:

MCP Conf

1 {
2   "mcpServers": {
3     "brevo_contacts": {
4       "command": "npx",
5       "args": [
6         "-y",
7         "mcp-remote",
8         "https://mcp.brevo.com/v1/brevo_contacts/mcp/YOUR_MCP_TOKEN"
9       ]
10     },
11     "brevo_deals": {
12       "command": "npx",
13       "args": [
14         "-y",
15         "mcp-remote",
16         "https://mcp.brevo.com/v1/brevo_deals/mcp/YOUR_MCP_TOKEN"
17       ]
18     },
19     "brevo_campaigns": {
20       "command": "npx",
21       "args": [
22         "-y",
23         "mcp-remote",
24         "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp/YOUR_MCP_TOKEN"
25       ]
26     }
27   }
28 }

Claude Configuration (using connectors)

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

Cursor

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

Download and install Cursor
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).
Add the following configuration (replacing YOUR_MCP_TOKEN with your actual token):

MCP Conf

1 {
2   "mcpServers": {
3     "brevo_contacts": {
4       "command": "npx",
5       "args": [
6         "-y",
7         "mcp-remote",
8         "https://mcp.brevo.com/v1/brevo_contacts/mcp/YOUR_MCP_TOKEN"
9       ]
10     },
11     "brevo_deals": {
12       "command": "npx",
13       "args": [
14         "-y",
15         "mcp-remote",
16         "https://mcp.brevo.com/v1/brevo_deals/mcp/YOUR_MCP_TOKEN"
17       ]
18     },
19     "brevo_campaigns": {
20       "command": "npx",
21       "args": [
22         "-y",
23         "mcp-remote",
24         "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp/YOUR_MCP_TOKEN"
25       ]
26     }
27   }
28 }

Cline/VSCode

Configuration for VSCode in .cline_mcp_settings.json:

JSON

1 {
2   "mcpServers": {
3     "brevo_complete": {
4       "command": "npx",
5       "args": [
6         "-y",
7         "mcp-remote",
8         "https://mcp.brevo.com/v1/brevo/mcp/YOUR_MCP_TOKEN"
9       ]
10     }
11   }
12 }

Custom Implementation

For custom MCP clients:

JavaScript

1 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
2 import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
3 
4 const transport = new SSEClientTransport(
5   new URL('https://mcp.brevo.com/v1/brevo_contacts/mcp/YOUR_MCP_TOKEN')
6 );
7 
8 const client = new Client(
9   {
10     name: "brevo-client",
11     version: "1.0.0"
12   },
13   {
14     capabilities: {}
15   }
16 );
17 
18 await client.connect(transport);

Service-Specific Tool Examples

Tools from different Brevo categories are mentioned as follows:

Contact Management

Tool	Description	Use Case
`get_contacts`	List contacts with filtering	Contact discovery and analysis
`get_contact_info`	Detailed contact information	Customer service and support
`create_contact`	Add new contacts	Lead capture and onboarding
`update_contact`	Modify contact data	Data maintenance and enrichment
`delete_contact`	Remove contacts	Data cleanup and compliance

Deal Management

Tool	Description	Use Case
`get_deals`	List deals with filtering	Sales pipeline analysis
`get_deal`	Detailed deal information	Deal review and updates
`create_deal`	Add new opportunities	Lead qualification and tracking
`update_deal`	Modify deal properties	Pipeline progression
`delete_deal`	Remove deals	Data cleanup

Email Campaign Management

Tool	Description	Use Case
`create_email_campaign`	Create marketing campaigns	Campaign launches
`get_email_campaigns`	List campaigns with stats	Performance monitoring
`send_email_campaign_now`	Send campaigns immediately	Campaign execution
`send_test_email_campaign`	Test before sending	Quality assurance
`get_campaign_details`	Detailed campaign analytics	Performance analysis

Analytics

Tool	Description	Use Case
`get_email_campaign_statistics`	Detailed email metrics	Performance evaluation
`get_sms_campaign_statistics`	SMS campaign analytics	Multi-channel analysis
`get_account_sending_statistics`	Account-wide metrics	Executive reporting
`get_campaign_comparison_analytics`	A/B testing analysis	Optimization insights

Example Usage

Python

1 # Through MCP-enabled AI assistant
2 prompt = """
3 Using the Brevo contacts tool, please:
4 1. Get all contacts from France
5 2. Show contacts created in the last week
6 3. Create a new contact for john@example.com with name "John Doe"
7 """