integrations tools activecampaign
ActiveCampaign MCP for your AI agent
Cogny's ActiveCampaign integration exposes 22 tools (13 read, 7 write, 2 destructive) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.
- 13readonly reads data.
- 7writecreates or changes something.
- 2destructivedeletes, removes or replaces something.
Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits
set it up.
Add Cogny to your AI client once, then connect ActiveCampaign in Cogny. Every ActiveCampaign tool below appears in the client.
- Claude CodeRun
claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser. - Claude.aiSettings → Connectors → Add custom connector, URL
https://app.cogny.com/mcp, then log in and pick your workspace. - ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL
https://app.cogny.com/mcp, authentication OAuth. - CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into
.mcp.json, with an API key. - CodexRun
codex mcp add cogny --url https://app.cogny.com/mcp.
Notes
ActiveCampaign connects with two values from ActiveCampaign → Settings → Developer: the API URL (it looks like https://youraccount.api-us1.com) and the API key. There are no scopes: the key has the permissions of the ActiveCampaign user it belongs to, so connect it as a user who can see the contacts, campaigns, automations and deals Cogny should work with.
Campaign stats come from ActiveCampaign's own counters: sent, opens, unique opens, link clicks, unique link clicks, forwards, hard and soft bounces, unsubscribes and replies. Rates are computed from them (open rate = unique opens / sent, click rate = unique link clicks / sent, click-to-open = unique clicks / unique opens).
Deal values are read and written in the deal's own currency; amounts in different currencies are never converted or added together.
ActiveCampaign allows 5 API requests per second per account. Lists return at most 100 items per call and page with offset.
Writes stay ask-first until you allow them in Settings. Adding a contact to an automation runs that automation for them, and subscribing a contact to a double opt-in list sends a confirmation email; tags can also start automations.
Known gaps
- Campaigns can't be created, edited, sent or scheduled. Campaign stats are totals per campaign; there is no per-day breakdown or per-contact open and click history.
- Click counts per link in a campaign aren't returned;
get_campaignlists the tracked links only. - No deletes: contacts, deals, lists, tags and automations can't be deleted.
- Automations can be listed and contacts added to them, but not built, edited, started or stopped.
- No site tracking, event tracking, ecommerce (Deep Data) orders, forms or SMS.
- Deal tasks and custom deal fields aren't exposed; deal notes are.
what each tool does.
Read 13 · only reads data
get_account_infoReadShow which ActiveCampaign account and user the connected API key belongs to, and the account's users.list_contactsReadList ActiveCampaign contacts, filtered by email, name or phone search, list, tag, status or date.get_contactReadGet one contact with its list memberships, tags, custom field values, deals and automations.list_contact_fieldsReadList the account's custom contact fields with their ids, types and personalization tags.list_tagsReadList contact tags with their ids and how many contacts carry each, optionally filtered by name.list_listsReadList the account's mailing lists with their ids.list_campaignsReadList email campaigns, newest send first, with sends, opens, clicks, bounces, unsubscribes and their rates.get_campaignReadGet one email campaign's stats and its tracked links.list_automationsReadList automations with their status and how many contacts entered and exited each.list_pipelinesReadList deal pipelines with their stages, so deals can be filtered, created and moved by stage id.list_dealsReadList CRM deals, newest first, filtered by search text, pipeline, stage, status (open, won, lost) or owner.get_dealReadGet one deal with its notes.list_accountsReadList CRM accounts (companies) with their contact and deal counts, optionally filtered by name.
Write 7 · creates or changes something
sync_contactWriteCreate a contact, or update the one with this email address.add_contact_to_listWriteSubscribe a contact to a list.add_tag_to_contactWriteTag a contact, by tag id or exact tag name; a name that doesn't exist yet becomes a new tag.add_contact_to_automationWriteAdd a contact to an automation, which then runs its steps for them (often sending email).create_dealWriteCreate a CRM deal for a contact in a pipeline stage.update_dealWriteUpdate a deal: move it to another stage, mark it open, won or lost, or change its value, title or owner.add_deal_noteWriteAdd a note to a deal, visible to everyone in the ActiveCampaign account.
Destructive 2 · deletes, removes or replaces something
unsubscribe_contact_from_listDestructiveUnsubscribe a contact from a list, so they stop receiving that list's campaigns.remove_tag_from_contactDestructiveRemove a tag from a contact, by tag id or exact tag name.
Exact input schemas come from tools/list once ActiveCampaign is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.