> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.brevo.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.brevo.com/_mcp/server.

# Tool configuration

## Before you start

You need a **Brevo MCP token**:

### Open API keys

Log in to your [Brevo account](https://app.brevo.com) and go to **Account > SMTP & API > API Keys**.

### Generate a new key

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

### 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](https://claude.ai/download) 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

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

#### Contacts only

```json
{
  "mcpServers": {
    "brevo_contacts": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo_contacts/mcp",
        "--header",
        "Authorization:Bearer ${BREVO_MCP_TOKEN}"
      ],
      "env": {
        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
      }
    }
  }
}
```

#### Multiple servers

```json
{
  "mcpServers": {
    "brevo_contacts": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo_contacts/mcp",
        "--header",
        "Authorization:Bearer ${BREVO_MCP_TOKEN}"
      ],
      "env": {
        "BREVO_MCP_TOKEN": "paste-your-mcp-token-here"
      }
    },
    "brevo_campaigns": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.brevo.com/v1/brevo_email_campaign_management/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](https://nodejs.org) installed on your machine.

---

## Claude Code (CLI)

[Claude Code](https://code.claude.com) is Anthropic's command-line tool for Claude.

The simplest way is to use the CLI:

```bash
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`:

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

```bash
claude mcp list
```

Requires [Node.js](https://nodejs.org) installed on your machine.

---

## Cursor

[Cursor](https://cursor.com) is an AI-powered code editor with native MCP support.

**Configuration file:** `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per project)

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

Restart Cursor after saving.

---

## Windsurf

[Windsurf](https://windsurf.com) is an AI-native IDE by Codeium.

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

```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](https://code.visualstudio.com/) supports MCP servers through GitHub Copilot.

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

```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](https://cline.bot) 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:

```json
{
  "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:

```json
{
  "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](/docs/mcp-protocol#individual-servers).

---

## Troubleshooting

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

Install [Node.js](https://nodejs.org) 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.