For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Help CenterAPI KeysStatusSign In
GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelog
  • Getting started
    • Overview
    • Quickstart
    • Authentication
    • Rate limits
        • Overview
        • Tool configuration
      • Connect to Cursor
  • Messaging API
    • Send transactional email
    • Send transactional SMS
    • Send transactional WhatsApp
  • Marketing Platform
    • Manage your contacts
    • Track website activity
    • Send WhatsApp campaigns
    • Weekly event exports
  • Webhooks
    • Getting started
    • Conversations webhooks
    • Payment webhooks
    • Marketing webhooks
    • Transactional webhooks
    • Loyalty webhooks
    • Batched webhooks
    • Secure webhook calls
    • Meetings and phone webhooks
    • Push notification webhooks
    • Sales CRM webhooks
  • Conversations
    • Getting started
    • Customize the chat widget
    • JavaScript API reference
    • REST API reference
    • Conversations webhooks
  • eCommerce
    • Activate eCommerce app
    • Manage product categories
    • Manage products
    • Manage orders
    • Coupon collections
    • eCommerce tracker events
  • Loyalty
    • Overview
    • Set up a program
    • Enroll members
    • Credit & debit points
    • Read member data
    • Best practices
  • Custom Objects
    • Custom objects management
  • Brevo tracker and events
    • Getting started
    • JavaScript implementation
    • REST implementation
    • Legacy tracker documentation
    • Events
  • Accounts and settings
    • Senders and domains
    • User activity logs
    • External feeds
    • Invited users
LogoLogo
Help CenterAPI KeysStatusSign In
On this page
  • Before you start
  • Claude Desktop
  • Claude Code (CLI)
  • Cursor
  • Windsurf
  • VS Code (GitHub Copilot)
  • Cline (VS Code extension)
  • Using individual servers
  • Troubleshooting
Getting startedSDKs and AI toolsMCP Protocol

Tool configuration

Detailed setup instructions for connecting each supported AI tool to the Brevo MCP server.
Was this page helpful?
Previous

Connect to Cursor

Learn how to connect the Brevo API documentation to Cursor via MCP server
Next
Built with

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
All features
Contacts only
Multiple servers
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.

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:

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

"Command not found: npx" (Claude Desktop / Claude Code)

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

Tools not appearing
  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.
Authentication errors
  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.