Mautic

This MCP server provides seamless integration with the Mautic marketing automation platform, exposing a rich set of capabilities to manage contacts, campaigns, emails, forms, segments, assets, and more through a single Model Context Protocol interface. It handles authentication, data synchronization, and automation tasks, enabling you to drive marketing workflows from your MCP client.

How to use

You connect to this MCP server from your MCP client and start issuing natural language commands or structured calls to manage your Mautic data. Begin by ensuring the server is running locally, then add the MCP server reference to your client configuration. Use commands to create, read, update, and delete entities such as contacts, campaigns, emails, forms, and segments. You can also trigger campaigns, retrieve analytics, and manage assets and notes as part of your automated workflows.

How to install

Prerequisites you need before installing are Node.js version 16 or higher and npm (or yarn) for package management. You also need access to a Mautic instance with API credentials.

Step-by-step installation and setup commands are below. Copy each snippet exactly as shown and run in your terminal.

# Clone the repository
git clone https://github.com/Cbrown35/mantic-MCP.git
cd mantic-MCP

# Install dependencies
npm install

# Configure your Mautic credentials
cp .env.example .env
# Edit .env with your Mautic API credentials

# Build and run
npm run build

Configure the MCP server in your client

Add the MCP server reference to your client's MCP configuration. The following is an example using a local stdio server configuration that you would place in your MCP configuration file.

{
  "mcpServers": {
    "mautic-server": {
      "type": "stdio",
      "name": "mautic_server",
      "command": "node",
      "args": ["/path/to/mautic-server/build/index.js"],
      "env": {
        "MAUTIC_BASE_URL": "https://your-mautic-instance.com/api/",
        "MAUTIC_CLIENT_ID": "your_client_id",
        "MAUTIC_CLIENT_SECRET": "your_client_secret",
        "MAUTIC_TOKEN_ENDPOINT": "https://your-mautic-instance.com/oauth/v2/token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Available tools

create_contact

Create new contacts with custom fields.

update_contact

Update existing contact information.

get_contact

Retrieve contact details by ID or email.

search_contacts

Search contacts with filters and pagination.

delete_contact

Remove contacts from Mautic.

add_contact_to_segment

Add contacts to specific segments.

list_campaigns

Get all campaigns with status and statistics.

get_campaign

Get detailed campaign information.

create_campaign

Create new campaigns.

add_contact_to_campaign

Add contacts to campaigns.

create_campaign_with_automation

Create campaigns with full event automation.

execute_campaign

Manually execute or trigger campaigns.

get_campaign_contacts

Get contacts in a campaign with their status.

send_email

Send emails to specific contacts.

list_emails

Get all email templates and campaigns.

get_email

Get detailed email information.

create_email_template

Create new email templates.

get_email_stats

Get email performance statistics.

list_forms

Get all forms with submission counts.

get_form

Get form details and fields.

get_form_submissions

Get form submission data.

list_segments

Get all contact segments.

create_segment

Create new contact segments with filters.

get_segment_contacts

Get contacts in a specific segment.

get_contact_activity

Get contact interaction history.

list_reports

Get all reports.

create_report

Create custom reports.

list_assets

Get all assets such as PDFs, images, and documents.

get_asset

Get asset details by ID.

create_asset

Create new assets (local or remote).

list_pages

Get all landing pages.

create_page

Create new landing pages.

list_sms

Get all SMS templates.

create_sms

Create SMS templates.

list_companies

Get all companies.

create_company

Create new companies.

add_contact_to_company

Associate contacts with companies.

create_note

Add notes to contacts or companies.

get_contact_notes

Get all notes for a contact.

list_tags

Get all available tags.

create_tag

Create new tags.

add_contact_tags

Add tags to contacts.

list_categories

Get all categories.

create_category

Create new categories.

add_contact_points

Add points to contacts.

subtract_contact_points

Subtract points from contacts.

list_stages

Get all lifecycle stages.

change_contact_stage

Change a contact's lifecycle stage.

list_contact_fields

Get all contact custom fields.

create_contact_field

Create new contact custom fields.

list_webhooks

Get all webhooks.

create_webhook

Create new webhooks.

upload_file

Upload files to Mautic.