Brevo

🚀 Brevo MCP (Multi-Channel Platform)

A Model Context Protocol (MCP) implementation designed for the Brevo API, aiming for seamless integration with Claude and other AI assistants.

🚀 Quick Start

1. Add the following content to your Claude Desktop configuration file (usually ~/.config/claude-next/config.json):

   {
     "MCPServers": {
       "brevo": {
         "command": ["npx", "@apicolet/brevo-mcp"],
         "config": {
           "apiKey": "your-brevo-api-key-here"
         }
       }
     }
   }
   

2. Restart Claude Desktop to load the configuration.

That's it! Now you can use Brevo features directly in your Claude conversations.

✨ Features

• ✉️ Email Management

  • Send transactional emails
  • Track email delivery and events
  • Beautiful email templates

• 👥 Contact Management

  • Create and update contacts
  • Manage custom attributes
  • Track contact activities

💻 Usage Examples

Basic Usage

Here are some examples of using Brevo MCP in Claude:

Sending an Email

// Send a transactional email
const result = await mcp.brevo.send_email({
  to: [{ 
    email: "recipient@example.com",
    name: "John Doe"
  }],
  subject: "Greetings from Claude!",
  htmlContent: "<h1>Welcome!</h1><p>This is a test email.</p>"
});

Managing Contacts

// Get contact details
const contact = await mcp.brevo.get_contact("john@example.com");

// Update contact attributes
await mcp.brevo.update_contact(contact.id, {
  attributes: {
    FIRSTNAME: "John",
    LASTNAME: "Doe",
    COMPANY: "Acme Inc"
  }
});

Advanced Usage

MCP provides several tools that can be used in Claude:

• get_contact: Get contact details by email or ID
• update_contact: Update contact attributes
• create_attribute: Create a new contact attribute
• send_email: Send a transactional email
• get_email_events: Track email delivery and interactions

📦 Installation

Setup

1. Clone the repository:

   git clone https://github.com/apicolet/brevo-mcp.git
   cd brevo-mcp
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Running Tests

npm test

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT

🔧 Technical Details

⚠️ Important Note

Keep your API key secure and never commit it to version control.

💡 Usage Tip

Use environment variables or the secure configuration section of Claude Desktop to store sensitive data. The MCP server only handles communication between Claude and Brevo and does not store any data locally.