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):

  1. Log in to app.brevo.com
  2. Go to Account > SMTP & API > API Keys
  3. Click Generate a new API key and toggle on Create MCP server API key
  4. 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

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 list

Available 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

EndpointDescription
https://mcp.brevo.com/v1/brevo/mcpAll 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

ServerEndpointPurpose
contacts/v1/brevo_contacts/mcpManage contacts and lists
lists/v1/brevo_lists/mcpManage contact lists
segments/v1/brevo_segments/mcpManage contact segments
attributes/v1/brevo_attributes/mcpManage contact attributes
groups/v1/brevo_groups/mcpManage contact groups
contact_import_export/v1/brevo_contact_import_export/mcpBulk import/export contacts

Campaigns & Messaging

ServerEndpointPurpose
email_campaign_management/v1/brevo_email_campaign_management/mcpCreate and manage email campaigns
campaign_analytics/v1/brevo_campaign_analytics/mcpView campaign performance
templates/v1/brevo_templates/mcpManage email templates
transac_templates/v1/brevo_transac_templates/mcpManage transactional email templates
sms_campaigns/v1/brevo_sms_campaigns/mcpCreate and send SMS campaigns
whatsapp_campaigns/v1/brevo_whatsapp_campaigns/mcpCreate and send WhatsApp campaigns
whatsapp_management/v1/brevo_whatsapp_management/mcpConfigure WhatsApp settings

Sales CRM

ServerEndpointPurpose
deals/v1/brevo_deals/mcpManage CRM deals
companies/v1/brevo_companies/mcpManage CRM companies
tasks/v1/brevo_tasks/mcpManage CRM tasks
pipelines/v1/brevo_pipelines/mcpConfigure CRM pipelines
notes/v1/brevo_notes/mcpAdd notes to contacts and deals

Account & Settings

ServerEndpointPurpose
senders/v1/brevo_senders/mcpManage sender identities
domains/v1/brevo_domains/mcpManage sender domains
ips/v1/brevo_ips/mcpManage dedicated IPs
accounts/v1/brevo_accounts/mcpManage account and sub-accounts
users/v1/brevo_users/mcpManage users and permissions
webhooks_management/v1/brevo_webhooks_management/mcpConfigure webhooks
external_feeds/v1/brevo_external_feeds/mcpManage RSS feeds
folders/v1/brevo_folders/mcpOrganise campaigns into folders
processes/v1/brevo_processes/mcpMonitor 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 tracked

Each 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 Authorization header is formatted as Bearer <token> with a space

Next Steps

AI Assistant

Hi! Ask me anything about the docs.

Start Free with Brevo