Richiedi l’accesso anticipato

Inserisci il tuo nome e indirizzo email aziendale. Ti invieremo un link per confermare la richiesta di accesso a Tajo.

In questa pagina

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.

This page is about Brevo’s server, which you connect to your own MCP client. Tajo agents do not use it; see How this relates to Tajo.

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.

Run this in your terminal. Claude Code stores the server in ~/.claude.json and connects to Brevo’s hosted server over HTTP:

claude mcp add --transport http brevo https://mcp.brevo.com/v1/brevo/mcp \
  --header "Authorization: Bearer paste-your-mcp-token-here"

Add --scope user to make it available in every project. Without it, the server is available only in the current project.

Verify with:

claude mcp list

Add 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 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

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

Individual Servers

Connect only the modules your client needs. A smaller tool list is easier for a model to choose from.

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 your own client

Connect only the servers a task needs. A client that only works on Brevo’s sales CRM, for example, needs deals, companies and pipelines:

{
  "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" }
    }
  }
}

The token behind each of these still has full access to your Brevo account. Scoping narrows what the model sees, not what the token allows.

How this relates to Tajo

Brevo’s server and Tajo are separate. Tajo agents do not connect to Brevo’s MCP server, and nothing on this page needs a Tajo workspace.

Inside Tajo, Brevo is reached through Tajo’s own Brevo connector. Writes from Tajo’s agents go through sync rules and sends you approve, and Tajo’s own MCP tools for Brevo stage each write until it is approved. See MCP & Agents and Tajo agents.

Troubleshooting

”Command not found: npx”

Install Node.js. The npx mcp-remote bridge is required for Claude Desktop.

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

MCP & Agents: what Tajo runs, and the MCP tools it serves
Tajo agents: each agent, what it never does, what waits for you
Brevo Official Docs: full Brevo MCP documentation