Getting startedSDKs and AI toolsMCP Protocol

Tool configuration

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

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
1{
2  "mcpServers": {
3    "brevo": {
4      "command": "npx",
5      "args": [
6        "mcp-remote",
7        "https://mcp.brevo.com/v1/brevo/mcp",
8        "--header",
9        "Authorization:Bearer ${BREVO_MCP_TOKEN}"
10      ],
11      "env": {
12        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
13      }
14    }
15  }
16}

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.

Configuration file: ~/.claude/config.json

1{
2  "mcpServers": {
3    "brevo": {
4      "command": "npx",
5      "args": [
6        "mcp-remote",
7        "https://mcp.brevo.com/v1/brevo/mcp",
8        "--header",
9        "Authorization: Bearer ${BREVO_MCP_TOKEN}"
10      ],
11      "env": {
12        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
13      }
14    }
15  }
16}

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)

1{
2  "mcpServers": {
3    "brevo": {
4      "url": "https://mcp.brevo.com/v1/brevo/mcp",
5      "headers": {
6        "Authorization": "Bearer paste-your-mcp-token-here"
7      }
8    }
9  }
10}

Restart Cursor after saving.

Windsurf

Windsurf is an AI-native IDE by Codeium.

Configuration file: ~/.codeium/windsurf/mcp_config.json

1{
2  "mcpServers": {
3    "brevo": {
4      "serverUrl": "https://mcp.brevo.com/v1/brevo/mcp",
5      "headers": {
6        "Authorization": "Bearer paste-your-mcp-token-here"
7      }
8    }
9  }
10}

VS Code (GitHub Copilot)

VS Code supports MCP servers through GitHub Copilot.

Configuration file: .vscode/mcp.json (per project) or user-level mcp.json

1{
2  "servers": {
3    "brevo": {
4      "type": "http",
5      "url": "https://mcp.brevo.com/v1/brevo/mcp",
6      "headers": {
7        "Authorization": "Bearer paste-your-mcp-token-here"
8      }
9    }
10  }
11}

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:

1{
2  "mcpServers": {
3    "brevo": {
4      "url": "https://mcp.brevo.com/v1/brevo/mcp",
5      "headers": {
6        "Authorization": "Bearer paste-your-mcp-token-here"
7      }
8    }
9  }
10}

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:

1{
2  "mcpServers": {
3    "brevo_contacts": {
4      "url": "https://mcp.brevo.com/v1/brevo_contacts/mcp",
5      "headers": {
6        "Authorization": "Bearer paste-your-mcp-token-here"
7      }
8    }
9  }
10}

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.