Email

Brevo MCP Server

Use Studio chat to drive this server — credentials stay in your workspace.

Brevo offers an email marketing service that enables businesses to send newsletters, manage email campaigns, and track performance metrics. It is primarily used for enhancing customer communication and engagement through targeted email marketing strategies.

51 tools
Agent guide included
API Key
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Brevo — workflow patterns, data models, and gotchas for your AI agent.

Brevo

Brevo is an all-in-one marketing platform: transactional email, contact management, CRM (deals, tasks, notes), and campaigns.

Data Model

  • Account: Plan info, credits, SMTP relay settings, timezone.
  • Contacts: Core entity. Identified by email, ID, SMS, or ext_id. UPPERCASE attributes (FIRSTNAME, LASTNAME, etc.). Searchable by attribute filter.
  • Contact Lists: Static groups of contacts. Organized into folders. Contacts can belong to multiple lists.
  • Segments: Dynamic groups based on conditions (auto-updating).
  • Companies: CRM companies with attributes (domain, industry, revenue). Link to contacts and deals. Searchable by attribute.
  • Deals: CRM deals with pipeline stages, amount, owner. Link to contacts and companies. Searchable by name, stage, owner, pipeline, linked entity.
  • Pipelines: Define deal flow stages (e.g. New → Qualified → Won/Lost). Pipeline view gives board-style overview.
  • Tasks: CRM tasks (Call, Email, Meeting, Todo) with due dates. Filterable by type, status, assignee, linked entity, date range.
  • Notes: Free-text notes linked to contacts/deals/companies. Must link to at least one entity.
  • Email Campaigns: Bulk marketing emails to lists/segments. Usually created as drafts, then sent in a separate step.
  • Email Templates: Reusable transactional templates with {{params.VAR}} substitution.
  • Senders: Verified email addresses authorized to send from your account.
  • Blocked Contacts: Transactional contacts blocked due to bounces, spam reports, or admin action.

Key Relationships & Linking

  • Contact → Lists (many-to-many via list membership)
  • Contact → Companies (linked via IDs)
  • Deal → Pipeline Stage (belongs to one pipeline)
  • Deal ↔ Contacts, Companies (linked via IDs)
  • Task → Contacts, Deals, Companies (linked via IDs)
  • Note → Contacts, Deals, Companies (must link to at least one)

IMPORTANT — full update vs incremental links: When you update a deal or company with a payload that includes linked entities, the vendor often replaces the entire linked-entity set. To add or remove individual links without wiping unrelated associations, use the dedicated link/unlink operations in the tool list for deals and companies.

Search & Filtering

  • Contacts: filter=equals(FIRSTNAME,"Jane") — search by any UPPERCASE attribute. Also filter by list_ids or segment_id.
  • Companies: filters={"attributes.name":"Acme"} or filters={"attributes.domain":"acme.com"}. Also filter by linked_contacts_ids or linked_deals_ids.
  • Deals: Filter by deal name, stage, owner, pipeline, or linked contact/company identifiers (see tool parameters).
  • Tasks: Filter by type, status (done/undone), date bucket (overdue/today/week/range), assignee, and linked contact/deal/company. Date range via date_from/date_to (ms timestamps).
  • Notes: Filter by entity type (contacts/deals/companies) and entity id.

Common Workflows

  1. Find a contact: Search by attribute filter (UPPERCASE keys) or by stable identifier such as email.
  2. Add contact and send welcome email: Create or update the contact, then send transactional mail.
  3. Bulk contact operations: Imports must target a list (existing or new); then manage list membership as needed.
  4. Email campaign flow: Create or update a draft campaign, then trigger send as its own step.
  5. Template-based emails: Create or select a template, then send with template parameters.
  6. Sales pipeline board: Use the pipeline/board-style view to see deals grouped by stage with counts and totals.
  7. Find deals for a contact: Filter deals by the linked contact.
  8. Find tasks for a deal: Filter CRM tasks by the linked deal.
  9. Link entities safely: Prefer incremental link/unlink when you must not disturb existing associations.
  10. Email debugging: Inspect email events, transactional send history, and aggregate stats.
  11. Deliverability: Review blocked contacts; remove blocks when appropriate.
  12. Scheduled email management: List scheduled sends and cancel if needed.
  13. Account audit: Review account settings, verified senders, and sending domains.

Vendor quirks

  • Contact attributes must use UPPERCASE keys (FIRSTNAME, not firstname). Resolve valid attribute names from metadata tools before writing filters.
  • Imports require either list_ids or new_list — imports without a target list fail validation.
  • Deleting a template auto-deactivates it first (Brevo only allows deleting inactive templates).
  • CRM notes require at least one linked entity (contact, deal, or company).
  • CRM tasks need a task type on creation — list task types first.
  • Some updates return minimal bodies (success with little or no JSON) even when the change applied.
  • Webhook listing may surface as “not found” on accounts with no webhooks; treat as an empty configuration.

Tools in this Server (51)

Brevo Cancel Scheduled Email

Cancel a scheduled transactional email before it is sent. Pass the batch ID (UUIDv4) to cancel all emails in the batch, or the message ID to cancel a ...

Brevo Delete Company

Permanently delete a company from the CRM. This cannot be undone.

Brevo Delete Contact

Permanently delete a contact from Brevo. This cannot be undone. Pass the contact's email address, numeric ID, or ext_id.

Brevo Delete Contact List

Permanently delete a contact list. The contacts themselves are not deleted — only the list is removed. This cannot be undone.

Brevo Delete Crm Note

Permanently delete a CRM note. This cannot be undone.

Brevo Delete Crm Task

Permanently delete a CRM task. This cannot be undone.

Brevo Delete Deal

Permanently delete a CRM deal. This cannot be undone.

Brevo Delete Email Campaign

Permanently delete an email campaign. This cannot be undone.

Brevo Delete Email Template

Permanently delete a transactional email template. This cannot be undone. Automatically deactivates the template first if it is currently active (Brev...

Brevo Get Account

Get your Brevo account details — organization name, owner email, plan info, sending credits (email + SMS), SMTP relay settings, address, and timezone....

Brevo Get Blocked Contacts

Get transactional contacts that are blocked or unsubscribed. Returns the email, reason (hardBounce, unsubscribed, adminBlocked, etc.), and date blocke...

Brevo Get Companies

Get a single company by ID, search by attributes, or list all companies. Use filters to search: filters={"attributes.name":"Acme"} or filters={"attrib...

Brevo Get Company Attributes

List all company attributes configured in your Brevo CRM. Returns attribute names, types, and labels. Use this to discover valid attribute keys before...

Brevo Get Contact Attributes

List all contact attributes configured in your Brevo account. Returns attribute names (e.g. FIRSTNAME, LASTNAME, EMAIL), their types, and categories (...

Brevo Get Contact Folders

Get a single folder by ID or list all contact folders. Folders organize contact lists. Returns folder ID, name, subscriber count, and the lists contai...

Brevo Get Contact Lists

Get a single contact list by ID or list all contact lists. Returns list name, subscriber count, folder, and creation date. Use the returned list IDs f...

Brevo Get Contacts

Get a single contact, search by attribute, or list contacts. Pass identifier (email, ID, SMS, ext_id) for one contact. Use filter to search by attribu...

Brevo Get Contact Stats

Get campaign statistics for a specific contact — opens, clicks, bounces, unsubscribes across all campaigns. Useful for understanding engagement histor...

Brevo Get Crm Notes

Get a single CRM note by ID or list notes. Returns note text (max 3000 chars), linked contact/deal/company IDs, creation date, and author. Filter by e...

Brevo Get Crm Tasks

Get a single CRM task by ID or list/search tasks with filters. Filter by type, status (done/undone), date (overdue/today/week/range), assignee, or lin...

Brevo Get Crm Task Types

List all CRM task types (e.g. Call, Email, Meeting, Todo). Returns task type ID and name. Use these IDs when creating tasks with brevo_upsert_crm_task...

Brevo Get Deal Attributes

List all CRM deal attributes configured in your Brevo account. Returns attribute names, types, and labels. Use this to discover valid attribute keys b...

Brevo Get Deal Pipeline View

Get an enriched pipeline board view — all deals organized by pipeline stage. Returns pipeline metadata (name, stages in order) plus deals grouped by s...

Brevo Get Deals

Get a single CRM deal by ID, search/filter deals, or list all deals. Search by deal name, filter by stage, pipeline, owner, or linked contact/company....

Brevo Get Domains

Get sender domains and their authentication status. List all domains to see which are authenticated (DKIM/SPF), or pass a domain_name to get its full ...

Brevo Get Email Campaigns

Get a single email campaign by ID or list all campaigns. Returns campaign name, subject, status, statistics (sent, opened, clicked, bounced), and sche...

Brevo Get Email Events

Get email delivery events — opens, clicks, bounces, deliveries, spam reports, unsubscribes, and more. Filter by recipient email, event type, date rang...

Brevo Get Email Stats

Get aggregated transactional email statistics — total requests, delivered, opens, clicks, bounces, spam reports, blocked, invalid, and unsubscribes. F...

Brevo Get Email Templates

Get a single email template by ID or list all transactional email templates. Returns template name, subject, HTML content, and active status. Use the ...

Brevo Get List Contacts

Get all contacts belonging to a specific contact list. Returns contact details including email, attributes, and subscription status. Use brevo_get_con...

Brevo Get Pipelines

List all CRM pipelines with their stages. Returns pipeline ID, name, and each stage's ID, name, and order. Use the returned pipeline and stage IDs whe...

Brevo Get Scheduled Emails

Check the status of scheduled transactional emails. Pass a batch ID (UUIDv4) to see all emails in a batch, or a message ID for a single email. Returns...

Brevo Get Segments

List all contact segments in your Brevo account. Segments are dynamic groups of contacts based on conditions (e.g. opened email in last 30 days). Retu...

Brevo Get Senders

List all verified email senders for your Brevo account. Returns sender ID, name, email, and active/verified status. Use a sender's email or ID with br...

Brevo Get Transac Emails

Get a single transactional email by UUID or list recent transactional emails. Returns email subject, recipient, date, template used, and messageId. Wh...

Brevo Get Webhooks

Get a single webhook by ID or list all webhooks. Returns webhook URL, events subscribed, type (marketing/transactional/inbound), and active status. Fi...

Brevo Import Contacts

Bulk import contacts into Brevo. Accepts a JSON array of contacts with email and optional attributes. You MUST specify either list_ids (existing list)...

Brevo Link Unlink Company

Link or unlink contacts and deals to/from a company without replacing existing links. Unlike brevo_upsert_company (which replaces the entire linked li...

Brevo Link Unlink Deal

Link or unlink contacts and companies to/from a deal without replacing existing links. Unlike brevo_upsert_deal (which replaces the entire linked list...

Brevo Manage List Contacts

Add or remove contacts from a contact list. Set action to 'add' to subscribe contacts or 'remove' to unsubscribe them. Pass up to 150 email addresses ...

Brevo Send Campaign

Send an email campaign immediately. The campaign must be in draft status with recipients, sender, subject, and content already configured. Use brevo_u...

Brevo Send Email

Send a transactional email via Brevo. Two modes: (1) Custom email: provide to, subject, html_content, and sender_email. (2) Template email: provide to...

Brevo Unblock Contact

Unblock or resubscribe a transactional contact that was previously blocked. Use brevo_get_blocked_contacts to find blocked emails first.

Brevo Upsert Company

Create a new company or update an existing one. To create: provide name (required) plus optional attributes, linked contacts/deals. To update: provide...

Brevo Upsert Contact

Create a new contact or update an existing one. To create: provide email (required) plus optional attributes and list_ids. To update: provide identifi...

Brevo Upsert Contact List

Create a new contact list or update an existing one. To create: provide name and folder_id (required). To update: provide list_id plus name and/or fol...

Brevo Upsert Crm Note

Create a new CRM note or update an existing one. To create: provide text (required, max 3000 chars) AND at least one linked entity (contact_ids, deal_...

Brevo Upsert Crm Task

Create a new CRM task or update an existing one. To create: provide name and task_type_id (both required), plus optional date, duration, notes, assign...

Brevo Upsert Deal

Create a new CRM deal or update an existing one. To create: provide name (required) plus optional attributes, linked contacts/companies. To update: pr...

Brevo Upsert Email Campaign

Create a new email campaign (draft) or update an existing one. To create: provide name, subject, sender_email, content (html_content or template_id), ...

Brevo Upsert Email Template

Create a new transactional email template or update an existing one. To create: provide template_name, subject, html_content (or html_url), and sender...

Frequently Asked Questions

What is the Brevo MCP server?

Brevo offers an email marketing service that enables businesses to send newsletters, manage email campaigns, and track performance metrics. It is primarily used for enhancing customer communication and engagement through targeted email marketing strategies. It provides 51 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Brevo to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/brevo. Authentication is handled automatically.

How many tools does Brevo provide?

Brevo provides 51 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Brevo require?

Brevo uses API Key. Brevo requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Brevo to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/brevo

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to chat with Brevo?

Same flow: Studio opens on this server after sign-in. Keep chatting to call tools from the conversation.

Brevo MCP Server & Skill — 51 Tools