Mautic API Skill: Control Your Entire Mautic Platform in Plain English

If your team uses Mautic every day, you know the friction: repetitive UI clicks, ad-hoc scripts, API docs open in one tab, terminal in another, and "just one more quick export" requests coming from sales and marketing.

We built something to remove that friction.

Today we're releasing Mautic API Skill - an open-source skill for Claude Code that lets you operate Mautic using natural language. Instead of manually assembling API payloads or writing one-off curl commands, you describe what you need in plain English and the tool handles the rest.

Source: mautomic-com/mautic-api-skill on GitHub

Why We Built It

Mautic is powerful, but power often comes with complexity - especially when you need to move fast across contacts, segments, campaigns, and reporting.

Common pain points we kept running into:

• Repetitive API operations that ate into productive hours
• Inconsistent scripts between teammates, each with their own curl wrappers
• Manual pagination and export handling for large datasets
• Constant context-switching between the Mautic UI, API docs, and terminal

The goal was simple: make advanced Mautic operations feel as easy as asking a teammate for help.

What It Does

Mautic API Skill gives you access to 24 Mautic resources and over 100 API actions through a single, consistent interface.

Supported Resources

You can manage:

• Contacts - create, edit, delete, bulk import/export, activity timelines, Do-Not-Contact lists
• Segments - build audience segments with filters, add or remove contacts
• Campaigns - manage campaigns, enroll or remove contacts, inspect events
• Emails - create templates, send broadcasts to segments, send to individual contacts
• Companies - B2B account management, link contacts to companies
• Lead Scoring - adjust points, manage pipeline stages
• Forms and Landing Pages - list forms, pull submissions, manage pages
• SMS and Push Notifications - create and send messages
• Webhooks - set up event-driven integrations
• Reports and Stats - pull report data, query raw stat tables
• Assets, Tags, Notes, Categories, Dynamic Content, Focus Items, Custom Fields - full CRUD on everything

Built-In Productivity Features

• Natural language control - describe what you need, Claude handles the API calls
• Auto-pagination - large result sets are handled transparently
• Flexible output formats - JSON, CSV, table, or raw response
• Mautic-native search syntax - use expressions like email:*@gmail.com, tag:customer, segment:VIP
• Bulk operations - batch create or delete contacts from JSON files
• Smart CSV export - auto-paginating export with a single command

How It Works Under the Hood

The skill wraps Mautic's REST API with a lightweight shell-based dispatcher (mautic-api.sh). It uses standard tools - curl and jq - to execute requests and shape output.

You (natural language) → Claude Code → mautic-api.sh → Mautic REST API

This architecture means:

• No heavy SDK dependencies
• Transparent, auditable operations
• Easy local setup
• Scriptable workflows that can be extended

It's tested with Mautic 7.x and released under the MIT license.

Getting Started

Setup is intentionally straightforward:

1. Install the skill from the GitHub repository - either ask Claude Code to install it directly, or clone manually to ~/.claude/skills/mautic-api
2. Run the setup script (bash ~/.claude/skills/mautic-api/scripts/setup.sh) to configure your Mautic URL, username, and password
3. Enable Mautic API in your instance at Settings → Configuration → API Settings → Enable API = Yes
4. Start using it - open Claude Code and describe what you need

Credentials are stored locally in .mautic-api.env with restrictive file permissions (600) for safe local usage.

Usage Examples

Here are a few things you can say to Claude once the skill is installed:

• "List all contacts tagged VIP"
• "Create a contact [email protected], first name Jan, last name Kowalski"
• "Export all newsletter contacts to CSV"
• "Add contact 42 to the Newsletter segment"
• "Send the welcome email to contact 42"
• "Show me all contacts who were active this week"
• "Create a segment for users with 100+ points"

For more control, you can also use specific commands with the /mautic prefix:

/mautic contacts list --search "email:*@gmail.com" --limit 50
/mautic contacts export --search "segment:VIP" > vip-contacts.csv
/mautic segments create '{"name":"High Value","isPublished":true,"filters":[...]}'
/mautic emails send-to-contact 10 42

Real Workflows This Unlocks

Here are common scenarios where Mautic API Skill saves real time:

• Marketing ops - pull and export segment-based contact lists in seconds instead of navigating through multiple UI screens
• Sales enablement - quickly inspect contact activity or lead stage changes without switching between tools
• Campaign execution - add or remove contacts from campaigns without the UI overhead
• Reporting - fetch operational snapshots for weekly dashboards with a single request
• Data hygiene - batch updates and cleanups via scripted bulk flows

Less time on tooling, more time on campaign strategy and execution.

Who It's For

• Teams already running Mautic who want faster daily operations
• Technical marketers and RevOps specialists comfortable with the terminal
• Developers supporting marketing automation workflows
• Agencies managing multiple Mautic clients

If you're currently juggling API snippets, one-off scripts, and manual exports, this should feel like a significant quality-of-life upgrade.

Summary

Mautic API Skill turns Mautic API tasks from "mini projects" into quick, reliable operations in plain language. It covers 24 resources and 100+ actions, requires no dependencies beyond curl and jq, and is fully open source under the MIT license.

Try it here: https://github.com/mautomic-com/mautic-api-skill

FAQ

Q: What version of Mautic is supported? A: The skill has been tested with Mautic 7.x. It uses the standard REST API, so it should work with any version that exposes the documented API endpoints.

Q: What authentication method does it use? A: Basic HTTP authentication. You'll need a Mautic user with API access. Credentials are stored locally with restricted file permissions.

Q: Can I use this with multiple Mautic instances? A: Yes. The skill loads credentials from the first .mautic-api.env file it finds - in the current directory, home directory, or skill directory. You can switch between instances by placing different config files in different project directories.

Q: Is this safe to use with production data? A: The skill executes standard Mautic API calls. It doesn't bypass any permissions or access controls - your Mautic user's role and permissions apply to every operation. That said, always test bulk operations (batch-delete, batch-create) on a staging instance first.

Related Articles

• Mautic Documentation
• Claude Code Skills

Want to automate your Mautic workflows? Check out the Mautic API Skill on GitHub and start managing your marketing automation platform in plain English.