Brevo Automation via Rube MCP
Automate Brevo (formerly Sendinblue) email marketing operations through Composio's Brevo toolkit via Rube MCP.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Brevo connection via
RUBE_MANAGE_CONNECTIONS with toolkit brevo
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit brevo
- If connection is not ACTIVE, follow the returned auth link to complete Brevo authentication
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Manage Email Campaigns
When to use: User wants to list, review, or update email campaigns
Tool sequence:
BREVO_LIST_EMAIL_CAMPAIGNS - List all campaigns with filters [Required]
BREVO_UPDATE_EMAIL_CAMPAIGN - Update campaign content or settings [Optional]
Key parameters for listing:
type: Campaign type ('classic' or 'trigger')
status: Campaign status ('suspended', 'archive', 'sent', 'queued', 'draft', 'inProcess', 'inReview')
startDate/endDate: Date range filter (YYYY-MM-DDTHH:mm:ss.SSSZ format)
statistics: Stats type to include ('globalStats', 'linksStats', 'statsByDomain')
limit: Results per page (max 100, default 50)
offset: Pagination offset
sort: Sort order ('asc' or 'desc')
excludeHtmlContent: Set true to reduce response size
Key parameters for update:
campaign_id: Numeric campaign ID (required)
name: Campaign name
subject: Email subject line
htmlContent: HTML email body (mutually exclusive with htmlUrl)
htmlUrl: URL to HTML content
sender: Sender object with name, email, or id
recipients: Object with listIds and exclusionListIds
scheduledAt: Scheduled send time (YYYY-MM-DDTHH:mm:ss.SSSZ)
Pitfalls:
startDate and endDate are mutually required; provide both or neither
- Date filters only work when
status is not passed or set to 'sent'
htmlContent and htmlUrl are mutually exclusive
- Campaign
sender email must be a verified sender in Brevo
- A/B testing fields (
subjectA, subjectB, splitRule, winnerCriteria) require abTesting: true
scheduledAt uses full ISO 8601 format with timezone
2. Create and Manage Email Templates
When to use: User wants to create, edit, list, or delete email templates
Tool sequence:
BREVO_GET_ALL_EMAIL_TEMPLATES - List all templates [Required]
BREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATE - Create a new template or update existing [Required]
BREVO_DELETE_EMAIL_TEMPLATE - Delete an inactive template [Optional]
Key parameters for listing:
templateStatus: Filter active (true) or inactive (false) templates
limit: Results per page (max 1000, default 50)
offset: Pagination offset
sort: Sort order ('asc' or 'desc')
Key parameters for create/update:
templateId: Include to update; omit to create new
templateName: Template display name (required for creation)
subject: Email subject line (required for creation)
htmlContent: HTML template body (min 10 characters; use this or htmlUrl)
sender: Sender object with name and email, or id (required for creation)
replyTo: Reply-to email address
isActive: Activate or deactivate the template
tag: Category tag for the template
Pitfalls:
- When
templateId is provided, the tool updates; when omitted, it creates
- For creation,
templateName, subject, and sender are required
htmlContent must be at least 10 characters
- Template personalization uses
{{contact.ATTRIBUTE}} syntax
- Only inactive templates can be deleted
htmlContent and htmlUrl are mutually exclusive
3. Manage Senders
When to use: User wants to view authorized sender identities
Tool sequence:
BREVO_GET_ALL_SENDERS - List all verified senders [Required]
Key parameters: (none required)
Pitfalls:
- Senders must be verified before they can be used in campaigns or templates
- Sender verification is done through the Brevo web interface, not via API
- Sender IDs can be used in
sender.id fields for campaigns and templates
4. Configure A/B Testing Campaigns
When to use: User wants to set up or modify A/B test settings on a campaign
Tool sequence:
BREVO_LIST_EMAIL_CAMPAIGNS - Find the target campaign [Prerequisite]
BREVO_UPDATE_EMAIL_CAMPAIGN - Configure A/B test settings [Required]
Key parameters:
campaign_id: Campaign to configure
abTesting: Set to true to enable A/B testing
subjectA: Subject line for variant A
subjectB: Subject line for variant B
splitRule: Percentage split for the test (1-99)
winnerCriteria: 'open' or 'click' for determining the winner
winnerDelay: Hours to wait before selecting winner (1-168)
Pitfalls:
- A/B testing must be enabled (
abTesting: true) before setting variant fields
splitRule is the percentage of contacts that receive variant A
winnerDelay defines how long to test before sending the winner to remaining contacts
- Only works with 'classic' campaign type
Common Patterns
Campaign Lifecycle
1. Create campaign (status: draft)
2. Set recipients (listIds)
3. Configure content (htmlContent or htmlUrl)
4. Optionally schedule (scheduledAt)
5. Send or schedule via Brevo UI (API update can set scheduledAt)
Pagination
- Use
limit (page size) and offset (starting index)
- Default limit is 50; max varies by endpoint (100 for campaigns, 1000 for templates)
- Increment
offset by limit each page
- Check
count in response to determine total available
Template Personalization
- First name: {{contact.FIRSTNAME}}
- Last name: {{contact.LASTNAME}}
- Custom attribute: {{contact.CUSTOM_ATTRIBUTE}}
- Mirror link: {{mirror}}
- Unsubscribe link: {{unsubscribe}}
Known Pitfalls
Date Formats:
- All dates use ISO 8601 with milliseconds: YYYY-MM-DDTHH:mm:ss.SSSZ
- Pass timezone in the date-time format for accurate results
startDate and endDate must be used together
Sender Verification:
- All sender emails must be verified in Brevo before use
- Unverified senders cause campaign creation/update failures
- Use GET_ALL_SENDERS to check available verified senders
Rate Limits:
- Brevo API has rate limits per account plan
- Implement backoff on 429 responses
- Template operations have lower limits than read operations
Response Parsing:
- Response data may be nested under
data or data.data
- Parse defensively with fallback patterns
- Campaign and template IDs are numeric integers
Quick Reference
| Task |
Tool Slug |
Key Params |
| List campaigns |
BREVO_LIST_EMAIL_CAMPAIGNS |
type, status, limit, offset |
| Update campaign |
BREVO_UPDATE_EMAIL_CAMPAIGN |
campaign_id, subject, htmlContent |
| List templates |
BREVO_GET_ALL_EMAIL_TEMPLATES |
templateStatus, limit, offset |
| Create template |
BREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATE |
templateName, subject, htmlContent, sender |
| Update template |
BREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATE |
templateId, htmlContent |
| Delete template |
BREVO_DELETE_EMAIL_TEMPLATE |
templateId |
| List senders |
BREVO_GET_ALL_SENDERS |
(none) |
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
🏰 Rei Skills — Curated by Rootcastle Engineering & Innovation | Batuhan Ayrıbaş
Engineering Beyond Boundaries | admin@rootcastle.com
1---2name: brevo-automation3description: "Automate Brevo (Sendinblue) tasks via Rube MCP (Composio): manage email campaigns, create/edit templates, track senders, and monitor campaign performance. Always search tools first for current sche..."4requires:5 mcp: [rube]6risk: unknown7source: rootcastle-rei8metadata:9 source: https://skillmd.com/skills/rootcastleco/brevo-automation10---1112# Brevo Automation via Rube MCP1314Automate Brevo (formerly Sendinblue) email marketing operations through Composio's Brevo toolkit via Rube MCP.1516## Prerequisites1718- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)19- Active Brevo connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `brevo`20- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas2122## Setup2324**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.2526271. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds282. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `brevo`293. If connection is not ACTIVE, follow the returned auth link to complete Brevo authentication304. Confirm connection status shows ACTIVE before running any workflows3132## Core Workflows3334### 1. Manage Email Campaigns3536**When to use**: User wants to list, review, or update email campaigns3738**Tool sequence**:391. `BREVO_LIST_EMAIL_CAMPAIGNS` - List all campaigns with filters [Required]402. `BREVO_UPDATE_EMAIL_CAMPAIGN` - Update campaign content or settings [Optional]4142**Key parameters for listing**:43- `type`: Campaign type ('classic' or 'trigger')44- `status`: Campaign status ('suspended', 'archive', 'sent', 'queued', 'draft', 'inProcess', 'inReview')45- `startDate`/`endDate`: Date range filter (YYYY-MM-DDTHH:mm:ss.SSSZ format)46- `statistics`: Stats type to include ('globalStats', 'linksStats', 'statsByDomain')47- `limit`: Results per page (max 100, default 50)48- `offset`: Pagination offset49- `sort`: Sort order ('asc' or 'desc')50- `excludeHtmlContent`: Set `true` to reduce response size5152**Key parameters for update**:53- `campaign_id`: Numeric campaign ID (required)54- `name`: Campaign name55- `subject`: Email subject line56- `htmlContent`: HTML email body (mutually exclusive with `htmlUrl`)57- `htmlUrl`: URL to HTML content58- `sender`: Sender object with `name`, `email`, or `id`59- `recipients`: Object with `listIds` and `exclusionListIds`60- `scheduledAt`: Scheduled send time (YYYY-MM-DDTHH:mm:ss.SSSZ)6162**Pitfalls**:63- `startDate` and `endDate` are mutually required; provide both or neither64- Date filters only work when `status` is not passed or set to 'sent'65- `htmlContent` and `htmlUrl` are mutually exclusive66- Campaign `sender` email must be a verified sender in Brevo67- A/B testing fields (`subjectA`, `subjectB`, `splitRule`, `winnerCriteria`) require `abTesting: true`68- `scheduledAt` uses full ISO 8601 format with timezone6970### 2. Create and Manage Email Templates7172**When to use**: User wants to create, edit, list, or delete email templates7374**Tool sequence**:751. `BREVO_GET_ALL_EMAIL_TEMPLATES` - List all templates [Required]762. `BREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATE` - Create a new template or update existing [Required]773. `BREVO_DELETE_EMAIL_TEMPLATE` - Delete an inactive template [Optional]7879**Key parameters for listing**:80- `templateStatus`: Filter active (`true`) or inactive (`false`) templates81- `limit`: Results per page (max 1000, default 50)82- `offset`: Pagination offset83- `sort`: Sort order ('asc' or 'desc')8485**Key parameters for create/update**:86- `templateId`: Include to update; omit to create new87- `templateName`: Template display name (required for creation)88- `subject`: Email subject line (required for creation)89- `htmlContent`: HTML template body (min 10 characters; use this or `htmlUrl`)90- `sender`: Sender object with `name` and `email`, or `id` (required for creation)91- `replyTo`: Reply-to email address92- `isActive`: Activate or deactivate the template93- `tag`: Category tag for the template9495**Pitfalls**:96- When `templateId` is provided, the tool updates; when omitted, it creates97- For creation, `templateName`, `subject`, and `sender` are required98- `htmlContent` must be at least 10 characters99- Template personalization uses `{{contact.ATTRIBUTE}}` syntax100- Only inactive templates can be deleted101- `htmlContent` and `htmlUrl` are mutually exclusive102103### 3. Manage Senders104105**When to use**: User wants to view authorized sender identities106107**Tool sequence**:1081. `BREVO_GET_ALL_SENDERS` - List all verified senders [Required]109110**Key parameters**: (none required)111112**Pitfalls**:113- Senders must be verified before they can be used in campaigns or templates114- Sender verification is done through the Brevo web interface, not via API115- Sender IDs can be used in `sender.id` fields for campaigns and templates116117### 4. Configure A/B Testing Campaigns118119**When to use**: User wants to set up or modify A/B test settings on a campaign120121**Tool sequence**:1221. `BREVO_LIST_EMAIL_CAMPAIGNS` - Find the target campaign [Prerequisite]1232. `BREVO_UPDATE_EMAIL_CAMPAIGN` - Configure A/B test settings [Required]124125**Key parameters**:126- `campaign_id`: Campaign to configure127- `abTesting`: Set to `true` to enable A/B testing128- `subjectA`: Subject line for variant A129- `subjectB`: Subject line for variant B130- `splitRule`: Percentage split for the test (1-99)131- `winnerCriteria`: 'open' or 'click' for determining the winner132- `winnerDelay`: Hours to wait before selecting winner (1-168)133134**Pitfalls**:135- A/B testing must be enabled (`abTesting: true`) before setting variant fields136- `splitRule` is the percentage of contacts that receive variant A137- `winnerDelay` defines how long to test before sending the winner to remaining contacts138- Only works with 'classic' campaign type139140## Common Patterns141142### Campaign Lifecycle143144```1451. Create campaign (status: draft)1462. Set recipients (listIds)1473. Configure content (htmlContent or htmlUrl)1484. Optionally schedule (scheduledAt)1495. Send or schedule via Brevo UI (API update can set scheduledAt)150```151152### Pagination153154- Use `limit` (page size) and `offset` (starting index)155- Default limit is 50; max varies by endpoint (100 for campaigns, 1000 for templates)156- Increment `offset` by `limit` each page157- Check `count` in response to determine total available158159### Template Personalization160161```162- First name: {{contact.FIRSTNAME}}163- Last name: {{contact.LASTNAME}}164- Custom attribute: {{contact.CUSTOM_ATTRIBUTE}}165- Mirror link: {{mirror}}166- Unsubscribe link: {{unsubscribe}}167```168169## Known Pitfalls170171**Date Formats**:172- All dates use ISO 8601 with milliseconds: YYYY-MM-DDTHH:mm:ss.SSSZ173- Pass timezone in the date-time format for accurate results174- `startDate` and `endDate` must be used together175176**Sender Verification**:177- All sender emails must be verified in Brevo before use178- Unverified senders cause campaign creation/update failures179- Use GET_ALL_SENDERS to check available verified senders180181**Rate Limits**:182- Brevo API has rate limits per account plan183- Implement backoff on 429 responses184- Template operations have lower limits than read operations185186**Response Parsing**:187- Response data may be nested under `data` or `data.data`188- Parse defensively with fallback patterns189- Campaign and template IDs are numeric integers190191## Quick Reference192193| Task | Tool Slug | Key Params |194|------|-----------|------------|195| List campaigns | BREVO_LIST_EMAIL_CAMPAIGNS | type, status, limit, offset |196| Update campaign | BREVO_UPDATE_EMAIL_CAMPAIGN | campaign_id, subject, htmlContent |197| List templates | BREVO_GET_ALL_EMAIL_TEMPLATES | templateStatus, limit, offset |198| Create template | BREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATE | templateName, subject, htmlContent, sender |199| Update template | BREVO_CREATE_OR_UPDATE_EMAIL_TEMPLATE | templateId, htmlContent |200| Delete template | BREVO_DELETE_EMAIL_TEMPLATE | templateId |201| List senders | BREVO_GET_ALL_SENDERS | (none) |202203## When to Use204This skill is applicable to execute the workflow or actions described in the overview.205206---207208> 🏰 **Rei Skills** — Curated by [Rootcastle Engineering & Innovation](https://www.rootcastle.com) | Batuhan Ayrıbaş 209> Engineering Beyond Boundaries | admin@rootcastle.com