Brevo MCP Server
Brevo MCP Server
Brevo provides an official hosted MCP server at mcp.brevo.com that exposes 27 modules — contacts, campaigns, deals, templates, WhatsApp, SMS, and more — as tools any AI agent can invoke. No local installation required.
Tip
The Brevo MCP Server uses the Model Context Protocol (MCP), an open standard by Anthropic that connects AI assistants to external tools and services.
Quick Start
1. Get Your MCP Token
Brevo MCP uses a dedicated MCP token (not a standard API key):
- Log in to app.brevo.com
- Go to Account > SMTP & API > API Keys
- Click Generate a new API key and toggle on Create MCP server API key
- Copy and store your token securely
Caution
Your MCP token grants full read/write access to your Brevo account. Never commit it to version control or share it publicly.
2. Connect Your AI Tool
Add to your Claude Desktop config 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" } } }}Restart Claude Desktop after saving. Requires Node.js installed.
Add to ~/.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" } } }}Verify with:
claude mcp listAdd to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):
{ "mcpServers": { "brevo": { "url": "https://mcp.brevo.com/v1/brevo/mcp", "headers": { "Authorization": "Bearer paste-your-mcp-token-here" } } }}Add to .vscode/mcp.json (per project) or user-level mcp.json:
{ "servers": { "brevo": { "type": "http", "url": "https://mcp.brevo.com/v1/brevo/mcp", "headers": { "Authorization": "Bearer paste-your-mcp-token-here" } } }}Add to ~/.codeium/windsurf/mcp_config.json:
{ "mcpServers": { "brevo": { "serverUrl": "https://mcp.brevo.com/v1/brevo/mcp", "headers": { "Authorization": "Bearer paste-your-mcp-token-here" } } }}3. Test the Connection
Once connected, ask your AI assistant:
> 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 listAvailable Servers
The main server at /v1/brevo/mcp includes all 27 modules. For better response quality with focused use cases, connect to individual servers that give your AI a smaller, more targeted toolset.
Main Server
| Endpoint | Description |
|---|---|
https://mcp.brevo.com/v1/brevo/mcp | All features combined (27 modules) |
Individual Servers
Connect only the modules your agent needs. This improves AI response quality by reducing tool surface area.
Contacts & CRM
| Server | Endpoint | Purpose |
|---|---|---|
| contacts | /v1/brevo_contacts/mcp | Manage contacts and lists |
| lists | /v1/brevo_lists/mcp | Manage contact lists |
| segments | /v1/brevo_segments/mcp | Manage contact segments |
| attributes | /v1/brevo_attributes/mcp | Manage contact attributes |
| groups | /v1/brevo_groups/mcp | Manage contact groups |
| contact_import_export | /v1/brevo_contact_import_export/mcp | Bulk import/export contacts |
Campaigns & Messaging
| Server | Endpoint | Purpose |
|---|---|---|
| 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 |
| 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 |
Sales CRM
| Server | Endpoint | Purpose |
|---|---|---|
| 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 |
Account & Settings
| Server | Endpoint | Purpose |
|---|---|---|
| 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 |
| folders | /v1/brevo_folders/mcp | Organise campaigns into folders |
| processes | /v1/brevo_processes/mcp | Monitor background processes |
All endpoints use the base URL https://mcp.brevo.com.
Scoping Tools for Agents
For Tajo agents, connect only the servers your agent needs. This is how you implement permission scoping — each agent gets a different set of MCP servers.
Example: Cart Recovery Agent
This agent only needs contacts, email campaigns, and SMS:
{ "mcpServers": { "brevo_contacts": { "url": "https://mcp.brevo.com/v1/brevo_contacts/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_email": { "url": "https://mcp.brevo.com/v1/brevo_email_campaign_management/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_templates": { "url": "https://mcp.brevo.com/v1/brevo_templates/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_sms": { "url": "https://mcp.brevo.com/v1/brevo_sms_campaigns/mcp", "headers": { "Authorization": "Bearer your-token" } } }}Example: Sales CRM Agent
This agent only works with deals and companies:
{ "mcpServers": { "brevo_deals": { "url": "https://mcp.brevo.com/v1/brevo_deals/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_companies": { "url": "https://mcp.brevo.com/v1/brevo_companies/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_pipelines": { "url": "https://mcp.brevo.com/v1/brevo_pipelines/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_tasks": { "url": "https://mcp.brevo.com/v1/brevo_tasks/mcp", "headers": { "Authorization": "Bearer your-token" } }, "brevo_notes": { "url": "https://mcp.brevo.com/v1/brevo_notes/mcp", "headers": { "Authorization": "Bearer your-token" } } }}How Tajo Uses Brevo MCP
Tajo sits between your intent and Brevo’s MCP tools. The orchestration flow:
Marketer Intent "Win back customers who haven't ordered in 90 days" ↓Tajo Agent Layer Selects: Win-Back Agent Agent reads its spec: tools, constraints, strategy ↓Brevo MCP Tools brevo_contacts → find churned customers brevo_segments → create target segment brevo_email → send recovery campaign brevo_sms → SMS follow-up for non-openers ↓Brevo Platform Emails delivered, SMS sent, events trackedEach Tajo agent spec declares which Brevo MCP servers it needs. The orchestration layer connects only those servers, enforcing least-privilege access.
Troubleshooting
”Command not found: npx”
Install Node.js. The npx mcp-remote bridge is required for Claude Desktop and Claude Code.
Tools not appearing
- Restart your application completely (not just reload)
- Verify your JSON has no syntax errors (trailing commas, missing brackets)
- Check that your MCP token has no extra spaces
Authentication errors
- Verify your MCP token is still active at Brevo Dashboard > SMTP & API
- Confirm the
Authorizationheader is formatted asBearer <token>with a space
Next Steps
- Building Your First Agent — Use Brevo MCP tools to build a marketing agent
- Agent Specification Format — Define custom agents with scoped tool access
- Skills Reference — See how Tajo Skills compose on top of MCP tools
- Brevo Official Docs — Full Brevo MCP documentation