Search

What is Model Context Protocol (MCP)?

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

  1. From Brevo, click the account dropdown and select Settings > 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 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.

💬 Was this article helpful?

6 out of 8 found this helpful