-
securityA
license-
qualityMCP Server for the Gentoro services, enabling Claude to interact with Gentoro, which allows users to create and integrate tools into a common Bridge, defining all available capabilities.
Last updated -
4
5
Apache 2.0
Provides comprehensive access to Brevo's marketing platform, including email operations, SMS and WhatsApp messaging, contact management, campaign management, conversations, webhooks, e-commerce integration, and account management.
Built with the official @getbrevo/brevo Node.js SDK for maximum compatibility with Brevo's platform.
Offers full TypeScript support for type-safe interactions with the Brevo API.
Enables WhatsApp integration as part of the Brevo platform, allowing for messaging through WhatsApp channels.
Brevo MCP Server
📧 Complete Brevo API Integration for Claude & Smithery using Official SDK
A comprehensive MCP server that provides Claude with full access to Brevo's marketing automation platform using the official @getbrevo/brevo Node.js SDK. Features 8 organized tools covering all major Brevo functionalities.
✨ Features
🔧 Official Brevo SDK - Built with
@getbrevo/brevofor maximum compatibility📧 Email Operations - Transactional emails, templates, tracking, events
📱 SMS & WhatsApp - Send SMS, manage campaigns, WhatsApp integration
👥 Contact Management - Contacts, lists, attributes, bulk operations
🎯 Campaign Management - Email and SMS campaigns, scheduling, analytics
💬 Conversations - Chat and conversation management
🔗 Webhooks - Event-driven automation and notifications
🛒 E-commerce - Orders, products, categories integration
🏢 Account Management - Senders, domains, folders, account info
🚀 Smithery Compatible - Ready for Smithery deployment
🛡️ Type-Safe - Full TypeScript support
🚀 Quick Start
Option 1: Using Smithery (Recommended)
Configure in Smithery:
brevo-mcp: apiKey: "your-brevo-api-key" # Required defaultSenderEmail: "your@domain.com" # Optional defaultSenderName: "Your Name" # Optional
Option 2: Local Installation
Install:
npm install npm run buildSet Environment Variables:
export BREVO_API_KEY="your-brevo-api-key" export BREVO_DEFAULT_SENDER_EMAIL="your@domain.com" export BREVO_DEFAULT_SENDER_NAME="Your Name"Run:
npm start
🛠️ Available Tools
1. contacts - Contact Management
Complete contact database operations with bulk capabilities.
Operations:
get- Retrieve contact by email/IDcreate- Create new contactupdate- Update contact informationdelete- Delete contactbulk_import- Import contacts in bulkexport- Export contactsadd_to_list/remove_from_list- List managementget_lists/create_list- Manage contact listsget_attributes/create_attribute/update_attribute- Custom attributes
Example:
{
"operation": "bulk_import",
"contacts": [
{
"email": "user1@example.com",
"attributes": {
"FIRSTNAME": "John",
"LASTNAME": "Doe"
}
}
]
}
2. email - Transactional Emails
Send emails, manage templates, track delivery and events.
Operations:
send- Send transactional emailsend_template- Send using templateget_events- Track email eventsget_templates- List email templatescreate_template/update_template/delete_template- Template managementget_blocked_domains- Check blocked domainsget_email_statistics- Email analytics
Example:
{
"operation": "send",
"to": [{"email": "recipient@example.com", "name": "John Doe"}],
"subject": "Welcome to our service",
"htmlContent": "<h1>Welcome!</h1><p>Thank you for joining us.</p>",
"sender": {"email": "noreply@yourcompany.com", "name": "Your Company"}
}
3. campaigns - Marketing Campaigns
Create and manage email and SMS marketing campaigns.
Operations:
get_email_campaigns/create_email_campaign/update_email_campaignsend_email_campaign/schedule_email_campaign/delete_email_campaignget_sms_campaigns/create_sms_campaign/update_sms_campaignsend_sms_campaign/schedule_sms_campaign/delete_sms_campaignget_campaign_statistics- Campaign analytics
Example:
{
"operation": "create_email_campaign",
"campaignData": {
"name": "Newsletter Campaign",
"subject": "Monthly Newsletter",
"htmlContent": "<h1>Newsletter</h1>",
"recipients": {"listIds": [1, 2]}
}
}
4. sms - SMS Operations
Send transactional SMS and manage SMS campaigns.
Operations:
send- Send single SMSsend_batch- Send to multiple recipientsget_events- Track SMS eventsget_statistics- SMS analytics
Example:
{
"operation": "send_batch",
"recipients": ["+1234567890", "+0987654321"],
"content": "Your order is ready for pickup!",
"sender": "YourBrand"
}
5. conversations - Chat Management
Handle customer conversations and chat interactions.
Operations:
get_conversations- List conversationsget_conversation- Get specific conversationget_messages- Get conversation messagessend_message- Send messageupdate_conversation- Update conversation status
6. webhooks - Event Automation
Manage webhooks for real-time event notifications.
Operations:
get_webhooks/create_webhook/update_webhook/delete_webhookget_webhook- Get specific webhook
Example:
{
"operation": "create_webhook",
"url": "https://your-app.com/brevo-webhook",
"events": ["delivered", "opened", "clicked"],
"description": "Email tracking webhook",
"type": "transactional"
}
7. account - Account Management
Manage account settings, senders, domains, and folders.
Operations:
get_account- Account informationget_senders/create_sender/update_sender/delete_senderget_domains/create_domain/validate_domainget_folders/create_folder/update_folder/delete_folder
8. ecommerce - E-commerce Integration
Manage orders, products, and categories for e-commerce tracking.
Operations:
get_orders/create_order/get_order/update_orderget_products/create_product/update_product/delete_productget_categories/create_category/update_category/delete_category
Example:
{
"operation": "create_order",
"orderData": {
"id": "order-123",
"email": "customer@example.com",
"products": [
{
"id": "product-1",
"name": "Widget",
"price": 29.99,
"quantity": 2
}
],
"total": 59.98
}
}
📋 Configuration
Environment Variables
Variable | Description | Required |
| Your Brevo API key | ✅ Yes |
| Default sender email | ❌ No |
| Default sender name | ❌ No |
| Enable debug logging | ❌ No |
Smithery Configuration
version: 1
startCommand:
type: stdio
configSchema:
type: object
required: ['apiKey']
properties:
apiKey:
type: string
description: "Brevo API key for authentication (required)"
defaultSenderEmail:
type: string
description: "Default sender email address"
defaultSenderName:
type: string
description: "Default sender name"
debug:
type: boolean
description: "Enable debug mode"
default: false
🔧 Development
# Install dependencies
npm install
# Build the project
npm run build
# Run the server
npm start
# Test the server
npm test
# Run with Smithery
npm run smithery
📊 Common Use Cases
Bulk Contact Import
{
"operation": "bulk_import",
"contacts": [
{
"email": "user1@example.com",
"attributes": {
"FIRSTNAME": "John",
"LASTNAME": "Doe",
"COMPANY": "Acme Corp"
}
}
]
}
Email Campaign with Tracking
{
"operation": "create_email_campaign",
"campaignData": {
"name": "Product Launch",
"subject": "Introducing Our New Product",
"htmlContent": "<h1>New Product Launch</h1>",
"recipients": {"listIds": [1]},
"scheduler": {
"sendAt": "2024-01-01T10:00:00Z"
}
}
}
E-commerce Order Tracking
{
"operation": "create_order",
"orderData": {
"id": "order-456",
"email": "customer@example.com",
"products": [
{"id": "prod-1", "name": "T-Shirt", "price": 25.00, "quantity": 1}
],
"total": 25.00,
"status": "pending"
}
}
🔒 Security
API keys are securely handled through environment variables
All communications use HTTPS through official Brevo SDK
Input validation on all tool parameters
Error handling prevents information leakage
📄 License
MIT License
🆘 Support
Issues: Report on GitHub
Brevo API Docs: https://developers.brevo.com/
Official SDK: https://github.com/getbrevo/brevo-node
Built with ❤️ using the official Brevo Node.js SDK for maximum reliability and features
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A comprehensive MCP server providing Claude with full access to Brevo's marketing automation platform through the official SDK, featuring tools for email operations, contact management, campaigns, SMS, conversations, webhooks, e-commerce, and account management.
Related MCP Servers
Tembo MCP Serverofficial
AsecurityAlicenseAqualityAn MCP server that enables Claude to interact with Tembo Cloud platform API, allowing users to manage Tembo Cloud resources through natural language.Last updated -107MIT License- AsecurityFlicenseAqualityA server built with mcp-framework that allows users to extend Claude's capabilities by adding custom tools that can be used through the Claude Desktop client.Last updated -331
- -securityAlicense-qualityAn MCP server implementation that integrates with the Civo cloud platform API, providing capabilities to manage cloud instances, networks, and Kubernetes clusters.Last updated -1973MIT License