Mautic MCP
A comprehensive Model Context Protocol (MCP) server that provides full integration with Mautic marketing automation platform.
What is Mautic MCP?
Mautic MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to comprehensive model context protocol (mcp) server that provides full integration with mautic marketing automation platform.
A comprehensive Model Context Protocol (MCP) server that provides full integration with Mautic marketing automation platform.
This server falls under the Marketing & SEO category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A comprehensive Model Context Protocol (MCP) server that pro
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mantic-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Mautic MCP
Mautic MCP Server provides full MCP integration with the Mautic 7 (Columba Edition) open-source marketing automation platform, exposing 68 tools that cover contacts, campaigns, emails, forms, segments, assets, landing pages, companies, tags, webhooks, reports, and the new API v2 Projects feature. It uses OAuth2 authentication with automatic token refresh and supports both Mautic's legacy v1 REST API (FOSRestBundle) and the new v2 API Platform endpoints. Marketing teams use it to automate contact management, build and execute campaigns, send targeted emails, and analyse performance — all through natural language.
Prerequisites
- Node.js 16 or higher and npm
- A running Mautic 7 instance with API access enabled (Settings → Configuration → API Settings → Enable HTTP basic auth and/or OAuth2)
- OAuth2 client credentials from your Mautic instance (Settings → API Credentials → New OAuth2 Client)
- Claude Desktop or another MCP-compatible client
Clone the repository and install dependencies
Clone the mantic-MCP repository and install npm dependencies.
git clone https://github.com/Cbrown35/mantic-MCP.git
cd mantic-MCP
npm installConfigure Mautic credentials
Copy the example environment file and fill in your Mautic instance URL and OAuth2 credentials. The MAUTIC_BASE_URL must end with /api/.
cp .env.example .env
# Edit .env with your credentials:
# MAUTIC_BASE_URL=https://your-mautic-instance.com/api/
# MAUTIC_CLIENT_ID=your_client_id_here
# MAUTIC_CLIENT_SECRET=your_client_secret_here
# MAUTIC_TOKEN_ENDPOINT=https://your-mautic-instance.com/oauth/v2/tokenBuild the server
Compile the TypeScript source to JavaScript in the build directory.
npm run buildAdd the server to your MCP client configuration
Open your claude_desktop_config.json and add the mautic-server entry, passing the Mautic credentials as environment variables.
{
"mcpServers": {
"mautic-server": {
"command": "node",
"args": ["/absolute/path/to/mantic-MCP/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"
}
}
}
}Restart Claude Desktop and verify the connection
Restart Claude Desktop. Ask it to list your Mautic contacts or campaigns to confirm the server is connected and OAuth2 authentication is working.
Mautic MCP Examples
Client configuration
Full claude_desktop_config.json entry for Mautic MCP Server using OAuth2 credentials.
{
"mcpServers": {
"mautic-server": {
"command": "node",
"args": ["/path/to/mantic-MCP/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"
}
}
}
}Prompts to try
Example natural language commands that map to the 68 tools exposed by the server.
- "Search for all contacts with gmail in their email address"
- "Create a new project to organize my Q1 campaign resources"
- "Clone campaign 5 and export it for staging"
- "Send email template 12 to its assigned segment"
- "List all active campaigns and their contact counts"
- "Add contact [email protected] to the Newsletter segment"
- "Get email performance statistics for email ID 8"Troubleshooting Mautic MCP
OAuth2 token request returns 'invalid_client' error
Verify that MAUTIC_CLIENT_ID and MAUTIC_CLIENT_SECRET match exactly what is shown in Mautic under Settings → API Credentials. Also confirm that MAUTIC_TOKEN_ENDPOINT ends with /oauth/v2/token (not /api/oauth/v2/token). Enable the Mautic API under Settings → Configuration → API Settings if you haven't already.
Tools that use v2 API endpoints (list_projects, clone_campaign, etc.) return 404
These tools require Mautic 7 (Columba Edition) or later. Check your Mautic version at Settings → System Info. If you are on Mautic 4 or 5, only the v1 API tools will work. SMS tools (list_sms, create_sms) are also removed in Mautic 7 and will return deprecation errors.
MAUTIC_BASE_URL returns connection refused or SSL errors
Ensure MAUTIC_BASE_URL includes the full URL with protocol (https://) and ends with /api/ (including the trailing slash). For self-hosted instances with self-signed certificates, you may need to set NODE_TLS_REJECT_UNAUTHORIZED=0 in the env block during development only — do not use in production.
Frequently Asked Questions about Mautic MCP
What is Mautic MCP?
Mautic MCP is a Model Context Protocol (MCP) server that comprehensive model context protocol (mcp) server that provides full integration with mautic marketing automation platform. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Mautic MCP?
Follow the installation instructions on the Mautic MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Mautic MCP?
Mautic MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Mautic MCP free to use?
Yes, Mautic MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Mautic MCP Alternatives — Similar Marketing & SEO Servers
Looking for alternatives to Mautic MCP? Here are other popular marketing & seo servers you can use with Claude, Cursor, and VS Code.
TopRank
★ 2.6kGoogle Ads analysis and operations — read performance, manage keywords, bids, and campaigns.
Open SEO
★ 2.1kOpen source alternative to Semrush and Ahrefs
ASO Skills
★ 1.4kAI agent skills for App Store Optimization (ASO) and app marketing. Built for indie developers, app marketers, and growth teams who want Cursor, Claude Code, or any Agent Skills-compatible AI assistant to help with keyword research, metadata optimiza
Google Meta Ads GA4
★ 994MCP server for Google Ads, Meta Ads & GA4 — works with ChatGPT, Claude, Cursor, n8n, Windsurf & more. 250+ tools for campaign management, analytics & optimization.
Meta Ads
★ 923A Model Context Protocol server that allows AI models to access, analyze, and manage Meta advertising campaigns, enabling LLMs to retrieve performance data, visualize ad creatives, and provide strategic insights for Facebook and Instagram platforms.
Google Search Console
★ 882Connects Google Search Console with Claude AI to enable SEO professionals to analyze their SEO data through natural language conversations, providing access to property information, search analytics, URL inspection, and sitemap management.
Browse More Marketing & SEO MCP Servers
Explore all marketing & seo servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Mautic MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Mautic MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.