mcp-activecampaign

Production-grade MCP server for the ActiveCampaign API — 33 tools for contacts, deals, automations, tags, pipelines, campaigns, custom fields, accounts, and webhooks.

The first MCP server for ActiveCampaign's 185,000+ customers.

Features

• Contacts — List, get, create, update, delete, and search contacts
• Deals — Full CRM deal management with pipeline and stage support
• Tags — Create tags and manage contact-tag associations
• Lists — View mailing lists and subscriber counts
• Automations — List automations and add contacts to workflows
• Pipelines & Stages — View deal pipelines and their stages
• Custom Fields — List fields, get/set values per contact
• Campaigns — View email campaign details and performance metrics
• Accounts — Manage B2B company records
• Webhooks — Create, list, and delete webhook subscriptions
• Rate limiting — Built-in 5 req/s throttle (ActiveCampaign's limit)
• Auto-retry — Automatic retry on 429 responses

Quick Start

Install

pip install mcp-activecampaign

Configure

Get your API URL and key from Settings > Developer in your ActiveCampaign account.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "activecampaign": {
      "command": "mcp-activecampaign",
      "env": {
        "ACTIVECAMPAIGN_URL": "https://youraccountname.api-us1.com",
        "ACTIVECAMPAIGN_API_KEY": "your-api-key"
      }
    }
  }
}

Environment Variables

export ACTIVECAMPAIGN_URL="https://youraccountname.api-us1.com"
export ACTIVECAMPAIGN_API_KEY="your-api-key"
mcp-activecampaign

Tools (33)

API Notes

• Auth: API key via Api-Token header (no OAuth required)
• Rate limit: 5 requests/second per account (handled automatically)
• Pagination: Offset-based — all list tools support limit and offset params
• Automations: Read-only via API — you can list and enroll contacts, but can't create or edit workflows
• Campaigns: Mostly read-only via API — view details and metrics

Development

git clone https://github.com/AlexlaGuardia/mcp-activecampaign.git
cd mcp-activecampaign
pip install -e ".[dev]"
pytest

License

MIT