Get the plugin
WP MCP/Integrations/FluentCRM MCP

FluentCRM MCP · Pro

FluentCRM MCP: contacts, lists and campaigns, handled by an AI agent.

A FluentCRM MCP server lets an AI agent look after your email list: find contacts, tag them, sort them into lists, draft a campaign. WP MCP runs every write through FluentCRM's own API, so its automations fire and its consent rules hold, and it snapshots each change first.

Self-hosted · snapshot before every write · one-click undo

What it is

What a FluentCRM MCP server does.

FluentCRM keeps a contact as a row with a status, its lists and tags in a pivot table, custom field values as meta rows, campaigns as their own rows and automations as funnels. A FluentCRM MCP server reads those tables for the agent and writes back through FluentCRM's API, so adding a contact to a list still triggers the automations that listen for it.

Consent is built in. A new contact is created pending and sent FluentCRM's double opt-in email unless the site allows direct subscribes, the only status a write may set is unsubscribed, and a contact who unsubscribed, bounced or complained is refused from any list. WP MCP cannot change a contact's email address, and contact listings mask emails and names.

Read and change

What WP MCP can read and change in FluentCRM.

It can read

  • A setup summary: contacts by status, lists, tags, campaigns, automations and the opt-in mode
  • Contacts filtered by search, list, tag and status, with emails and names masked
  • One contact by id or email, with lists, tags and custom field values
  • Lists and tags with member counts, and custom field definitions
  • Campaigns with status, schedule and recipient count, and automations with enrolled counts

It can change

  • Create a contact, update its name and custom fields, or unsubscribe it
  • Tag and untag a contact, and add it to or remove it from lists
  • Create, rename and delete lists and tags, and import up to 100 contacts per call
  • Create, update and duplicate a draft campaign, and send a test to yourself
  • Send or schedule a campaign (opt-in, asks for confirmation with the recipient count)
  • Set an automation to published or draft
plugin-data-readplugin-data-writefluentcrm-list-contactsfluentcrm-update-contact-tagsfluentcrm-create-campaignfluentcrm-send-campaign

These are the real ability and operation names the agent calls. TheFluentCRM AI agent tool reference page lists the calls in detail.

Example prompts

Three things to ask first.

Summarise our FluentCRM setup and tell me how new contacts are opted in.

Find the contacts tagged Webinar signup who are still pending.

Draft the November update campaign for the Newsletter list and send me a test.

Safety

Every FluentCRM write has a way back.

Contact, list, tag, campaign draft and automation writes are each snapshotted as a CRM rows image, and rollback-operation restores them. A deleted contact comes back with its memberships, a deleted list or tag with up to 5000 members, and rollback-session undoes a whole import. Rollback never sets anyone back to a mailable status.

Snapshot before every write

No tool that writes can skip it. The before-state is saved first, the change is applied second.

One-click undo

Restore a single change with rollback-operation or a whole agent run with rollback-session, from the agent or from wp-admin.

Mail cannot be unsent

Sending a campaign is off until the site enables it, and asks for confirmation with the recipient count. A send or a test email is snapshotted, but its undo is refused, because the mail has already gone.

Free or Pro

Part of WP MCP Pro.

FluentCRM support is part of WP MCP Pro, as operations on the plugin-data pair, so it adds no top-level tools. Reads and everyday writes need a licence and FluentCRM's own permissions; sending a campaign is a separate opt-in. With an active licence, Pro keeps unlimited snapshot history; the free plugin keeps the last 20.

WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.

How to connect

Connect FluentCRM MCP in four steps.

  1. 01
    Install WP MCP

    Upload the free wpmcp plugin and activate it. It needs WordPress 6.9 or newer and PHP 8.1 or newer, and it runs entirely on your own server.

  2. 02
    Check the requirement

    FluentCRM active. Campaign sending is off until the site enables it with the wpmcp_enable_crm_send filter; FluentCRM's own permissions apply to every operation.

  3. 03
    Connect your client

    Add the site to Claude Code, Claude Desktop, Cursor or any MCP client with a WordPress application password, or the WP-CLI stdio bridge locally. OAuth 2.1 with full or read-only access is there too, once the site owner switches it on.

  4. 04
    Ask for the change

    Describe what you want done in FluentCRM. WP MCP snapshots the target, makes the change, and leaves a Restore button next to it in wp-admin.

Step-by-step guides: Claude,Claude Code andCursor. The docscover the safety model in full.

Frequently asked

FluentCRM MCP: questions, answered.

What is FluentCRM MCP?

It is FluentCRM made available to AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client read and manage contacts, lists, tags, draft campaigns and automation status, through FluentCRM's own API.

Can the agent resubscribe someone who opted out?

No. The only status a write may set is unsubscribed, a contact who unsubscribed, bounced or complained is refused from any list, and a rollback never makes anyone mailable again.

Can it send a campaign on its own?

Not by default. Sending is off until the site opts in with a filter, and even then the call first answers with the recipient count for you to confirm. A test only ever goes to the current user's own email.

Can it build or edit automation steps?

No. It lists automations with their status and enrolled count and can set one to published or draft. The steps themselves are edited in FluentCRM.

Is FluentCRM MCP free?

No. FluentCRM support is part of WP MCP Pro. The free plugin does not expose FluentCRM operations.

Does FluentCRM MCP work with Claude, Claude Code and Cursor?

Yes. Claude Code and Cursor connect to WP MCP over HTTP with a WordPress application password, and Claude Desktop uses the desktop bundle from the WP MCP Connection screen. Clients that can only sign in with OAuth, such as the claude.ai custom connector, need OAuth switched on first with one line in wp-config.php, because it ships off. Once connected, the FluentCRM tools are available in every client the same way.

Point your AI agent at FluentCRM.