Tool configuration

Detailed setup instructions for connecting each supported AI tool to the Brevo MCP server.
View as Markdown

Before you start

You need a Brevo MCP token:

1

Open API keys

Log in to your Brevo account and go to Account > SMTP & API > API Keys.

2

Generate a new key

Click Generate a new API key and toggle on Create MCP server API key.

3

Copy and store your token

Copy your token immediately and store it securely. It grants full read/write access to your account.


Claude Desktop

Claude Desktop is Anthropic’s desktop app for Claude.

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

Restart Claude Desktop after saving. Tools will appear in the tool picker.

Requires Node.js installed on your machine.

Claude Code (CLI)

Claude Code is Anthropic’s command-line tool for Claude.

The simplest way is to use the CLI:

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

Alternatively, add the server manually to ~/.claude.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 the server is registered:

claude mcp list
Requires Node.js installed on your machine.

Cursor

Cursor is an AI-powered code editor with native MCP support.

Configuration file: ~/.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"
}
}
}
}

Restart Cursor after saving.


Windsurf

Windsurf is an AI-native IDE by Codeium.

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)

VS Code supports MCP servers through GitHub Copilot.

Configuration file: .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"
}
}
}
}

Cline (VS Code extension)

Cline is a VS Code extension for AI-assisted coding.

Configuration file: Open Cline’s MCP settings from the extension panel, or edit cline_mcp_settings.json directly:

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

Using individual servers

All examples above use the main server (/v1/brevo/mcp), which includes all features. To use a specific module, replace the URL with the individual server endpoint.

Example — contacts server only in Cursor:

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

See the full list of available servers.


Troubleshooting

Install Node.js on your machine. npx is required for Claude Desktop and Claude Code, which use the mcp-remote bridge.

  1. Restart your application completely (not just reload the window).
  2. Verify your JSON is valid — no trailing commas, correct brackets.
  3. Check that your MCP token is correct and has no extra spaces.
  1. Verify your MCP token is still active in Brevo Dashboard > SMTP & API.
  2. Confirm you copied the full token without leading or trailing spaces.
  3. Ensure the Authorization header value is formatted as Bearer <token> with a space between Bearer and the token.