Mautic MCP Server

This is an MCP (Model Context Protocol) server that wraps the Mautic API using the Stainless-generated TypeScript SDK.

Installation

npm install
npm run build

Configuration

Set the following environment variables:

# Mautic API Configuration
export MAUTIC_BASE_URL="https://your-mautic-instance.com/api"
export MAUTIC_USERNAME="your-username"     # For Basic Auth
export MAUTIC_PASSWORD="your-password"     # For Basic Auth
# OR
export MAUTIC_API_KEY="your-api-key"       # For API Key auth

Alternatively, you can use the SDK's default environment variable names:

• LISTMONK_PATIENT_CTHR_BASE_URL
• LISTMONK_PATIENT_CTHR_USERNAME
• LISTMONK_PATIENT_CTHR_PASSWORD
• LISTMONK_PATIENT_CTHR_API_KEY

Usage

Running the Server

npm start

Available Tools

Lists (Segments) Management

• mautic_list_lists - Get all Mautic lists/segments
• mautic_create_list - Create a new list/segment
• mautic_get_list - Get a specific list/segment

Contacts Management

• mautic_list_contacts - Get all contacts
• mautic_create_contact - Create a new contact
• mautic_get_contact - Get a specific contact
• mautic_update_contact - Update a contact

Campaigns Management

• mautic_list_campaigns - Get all campaigns
• mautic_create_campaign - Create a new campaign
• mautic_get_campaign - Get a specific campaign
• mautic_update_campaign_status - Update campaign status

Templates Management

• mautic_list_templates - Get all email templates
• mautic_create_template - Create a new email template

Media Management

• mautic_list_media - Get all media files
• mautic_upload_media - Upload a media file

Settings Management

• mautic_update_settings - Update Mautic settings

Health Check

• mautic_health_check - Check API health status

Integration with Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "mautic": {
      "command": "node",
      "args": ["/path/to/mautic-mcp-wrapper/dist/index.js"],
      "env": {
        "MAUTIC_BASE_URL": "https://your-mautic-instance.com/api",
        "MAUTIC_USERNAME": "your-username",
        "MAUTIC_PASSWORD": "your-password"
      }
    }
  }
}

Development

# Run in development mode
npm run dev

# Build for production
npm run build

Note

This MCP server uses the Stainless-generated SDK which was created with the name "listmonk-patient-cthr" but actually contains the Mautic API implementation.