The Brevo MCP server lets you use AI assistants to interact with your Brevo account using natural language. Instead of navigating the Brevo interface manually, you can ask your AI assistant questions like:

"How many contacts do I have?"
"Create an email campaign for my product launch"
"Show me deals in the Negotiation stage"
"Add a contact to my newsletter list"

The Brevo MCP server works with popular AI tools such as Claude Desktop, Cursor, Windsurf, VS Code, and more. The server uses the Model Context Protocol (MCP), an open standard by Anthropic that connects AI assistants to external tools and services.

Good to know

To learn more about the Model Context Protocol (MCP), check our developer documentation.

Connect your AI with Brevo

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

Step 1: Create your MCP token

From Brevo, click the account dropdown and select Settings > SMTP & API > API Keys & MCP.
Click Generate a new API key.
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.
Click Generate.
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.
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.
Click OK.

Step 2: Connect your AI assistant

Expand the following accordions to follow the configuration instructions of your corresponding AI tool:

Claude Desktop

❗️ Important

Node.js needs to be installed on your machine.

Add the following code to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "brevo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo/mcp",
        "--header",
        "Authorization: Bearer ${BREVO_MCP_TOKEN}"
      ],
      "env": {
        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
      }
    }
  }
}

After saving, restart Claude Desktop.

Cursor

Add the following code to your Cursor configuration file: ~/.cursor/mcp.json:

{
  "mcpServers": {
    "brevo": {
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

After saving, restart Cursor.

Windsurf

Add the following code to your Windsurf configuration file: ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "brevo": {
      "serverUrl": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add the following code to your configuration file: /.vscode/mcp.json in your projects:

{
  "servers": {
    "brevo": {
      "type": "http",
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

Cline (VS Code)

Add the following code to your Cline configuration file in Cline's MCP settings:

{
  "mcpServers": {
    "brevo": {
      "url": "https://mcp.brevo.com/v1/brevo/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

Claude Code (CLI)

Add the following code to your Claude Code (CLI) configuration file: ~/.claude/config.json:

{
  "mcpServers": {
    "brevo": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo/mcp",
        "--header",
        "Authorization: Bearer ${BREVO_MCP_TOKEN}"
      ],
      "env": {
        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
      }
    }
  }
}

Available MCP Servers

You can connect to the main server for access to all features, or to individual servers for specific needs. Using individual servers gives your AI assistant a smaller set of tools, which can improve response quality.

Main server

Endpoint	Description
`https://mcp.brevo.com/v1/brevo/mcp`	All features combined (27 modules)

Individual servers

All endpoints use the base URL https://mcp.brevo.com.

Server	Endpoint	Description
contacts	`/v1/brevo_contacts/mcp`	Manage contacts and lists
email_campaign_management	`/v1/brevo_email_campaign_management/mcp`	Create and manage email campaigns
campaign_analytics	`/v1/brevo_campaign_analytics/mcp`	View campaign performance
templates	`/v1/brevo_templates/mcp`	Manage email templates
transac_templates	`/v1/brevo_transac_templates/mcp`	Manage transactional email templates
deals	`/v1/brevo_deals/mcp`	Manage CRM deals
companies	`/v1/brevo_companies/mcp`	Manage CRM companies
tasks	`/v1/brevo_tasks/mcp`	Manage CRM tasks
pipelines	`/v1/brevo_pipelines/mcp`	Configure CRM pipelines
notes	`/v1/brevo_notes/mcp`	Add notes to contacts and deals
sms_campaigns	`/v1/brevo_sms_campaigns/mcp`	Create and send SMS campaigns
whatsapp_campaigns	`/v1/brevo_whatsapp_campaigns/mcp`	Create and send WhatsApp campaigns
whatsapp_management	`/v1/brevo_whatsapp_management/mcp`	Configure WhatsApp settings
lists	`/v1/brevo_lists/mcp`	Manage contact lists
segments	`/v1/brevo_segments/mcp`	Manage contact segments
attributes	`/v1/brevo_attributes/mcp`	Manage contact attributes
contact_import_export	`/v1/brevo_contact_import_export/mcp`	Import and export contacts in bulk
folders	`/v1/brevo_folders/mcp`	Organize campaigns into folders
groups	`/v1/brevo_groups/mcp`	Manage contact groups
senders	`/v1/brevo_senders/mcp`	Manage sender identities
domains	`/v1/brevo_domains/mcp`	Manage sender domains
ips	`/v1/brevo_ips/mcp`	Manage dedicated IPs
accounts	`/v1/brevo_accounts/mcp`	Manage account and sub-accounts
users	`/v1/brevo_users/mcp`	Manage users and permissions
webhooks_management	`/v1/brevo_webhooks_management/mcp`	Configure webhooks
external_feeds	`/v1/brevo_external_feeds/mcp`	Manage RSS feeds
processes	`/v1/brevo_processes/mcp`	Monitor background processes

To use an individual server, replace the main server URL in your configuration. For example, to use only the contacts server in Cursor:

{
  "mcpServers": {
    "brevo_contacts": {
      "url": "https://mcp.brevo.com/v1/brevo_contacts/mcp",
      "headers": {
        "Authorization": "Bearer paste-your-mcp-token-here"
      }
    }
  }
}

⏭️ What's next?

🤔 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.

What is Model Context Protocol (MCP)?

Good to know

Connect your AI with Brevo

Step 1: Create your MCP token

Step 2: Connect your AI assistant

Available MCP Servers

Main server

Individual servers

⏭️ What's next?

🤔 Have a question?

💬 Was this article helpful?

Search

What is Model Context Protocol (MCP)?

Good to know

Connect your AI with Brevo

Step 1: Create your MCP token

Step 2: Connect your AI assistant

Available MCP Servers

Main server

Individual servers

⏭️ What's next?

🤔 Have a question?

💬 Was this article helpful?