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/brevo for 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)

1. Configure in Smithery:

   brevo-mcp:
     apiKey: "your-brevo-api-key"           # Required
     defaultSenderEmail: "[email protected]" # Optional
     defaultSenderName: "Your Name"        # Optional

Option 2: Local Installation

1. Install:

   npm install
   npm run build

2. Set Environment Variables:

   export BREVO_API_KEY="your-brevo-api-key"
   export BREVO_DEFAULT_SENDER_EMAIL="[email protected]"
   export BREVO_DEFAULT_SENDER_NAME="Your Name"

3. Run:

   npm start

🛠️ Available Tools

1. contacts - Contact Management

Complete contact database operations with bulk capabilities.

Operations:

• get - Retrieve contact by email/ID
• create - Create new contact
• update - Update contact information
• delete - Delete contact
• bulk_import - Import contacts in bulk
• export - Export contacts
• add_to_list / remove_from_list - List management
• get_lists / create_list - Manage contact lists
• get_attributes / create_attribute / update_attribute - Custom attributes

Example:

{
  "operation": "bulk_import",
  "contacts": [
    {
      "email": "[email protected]",
      "attributes": {
        "FIRSTNAME": "John",
        "LASTNAME": "Doe"
      }
    }
  ]
}

2. email - Transactional Emails

Send emails, manage templates, track delivery and events.

Operations:

• send - Send transactional email
• send_template - Send using template
• get_events - Track email events
• get_templates - List email templates
• create_template / update_template / delete_template - Template management
• get_blocked_domains - Check blocked domains
• get_email_statistics - Email analytics

Example:

{
  "operation": "send",
  "to": [{"email": "[email protected]", "name": "John Doe"}],
  "subject": "Welcome to our service",
  "htmlContent": "<h1>Welcome!</h1><p>Thank you for joining us.</p>",
  "sender": {"email": "[email protected]", "name": "Your Company"}
}

3. campaigns - Marketing Campaigns

Create and manage email and SMS marketing campaigns.

Operations:

• get_email_campaigns / create_email_campaign / update_email_campaign
• send_email_campaign / schedule_email_campaign / delete_email_campaign
• get_sms_campaigns / create_sms_campaign / update_sms_campaign
• send_sms_campaign / schedule_sms_campaign / delete_sms_campaign
• get_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 SMS
• send_batch - Send to multiple recipients
• get_events - Track SMS events
• get_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 conversations
• get_conversation - Get specific conversation
• get_messages - Get conversation messages
• send_message - Send message
• update_conversation - Update conversation status

6. webhooks - Event Automation

Manage webhooks for real-time event notifications.

Operations:

• get_webhooks / create_webhook / update_webhook / delete_webhook
• get_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 information
• get_senders / create_sender / update_sender / delete_sender
• get_domains / create_domain / validate_domain
• get_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_order
• get_products / create_product / update_product / delete_product
• get_categories / create_category / update_category / delete_category

Example:

{
  "operation": "create_order",
  "orderData": {
    "id": "order-123",
    "email": "[email protected]",
    "products": [
      {
        "id": "product-1",
        "name": "Widget",
        "price": 29.99,
        "quantity": 2
      }
    ],
    "total": 59.98
  }
}

📋 Configuration

Environment Variables

Variable	Description	Required
BREVO_API_KEY	Your Brevo API key	✅ Yes
BREVO_DEFAULT_SENDER_EMAIL	Default sender email	❌ No
BREVO_DEFAULT_SENDER_NAME	Default sender name	❌ No
DEBUG	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": "[email protected]",
      "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": "[email protected]",
    "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