FluentCRM MCP Server
Enables management of FluentCRM marketing automation through WordPress, providing tools for contact management, email campaigns, tags, lists, automations, webhooks, and reporting directly within the FluentCRM platform.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@FluentCRM MCP Server show me all contacts in the 'Newsletter Subscribers' list"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🚀 FluentCRM MCP Server
MCP Server for FluentCRM - manage your entire marketing automation directly from Cursor!
📋 Table of Contents
Related MCP server: GHL MCP Server
What is MCP Server?
MCP (Model Context Protocol) is a new standard from Anthropic that allows AI models (including Claude in Cursor) to connect to external systems.
This MCP Server allows you to:
✅ Manage tags - create, delete, assign to contacts
✅ Edit lists - create lists, add/remove contacts
✅ Create campaigns - send emails to user segments
✅ Automations - manage funnels (automations)
✅ Webhooks - configure webhooks to FluentCRM
✅ Reports - fetch statistics and metrics
✅ Smart Links - manage smart links (when API becomes available)
Everything directly from Cursor, in conversation with Claude!
Requirements
✅ Node.js 18+
✅ npm or yarn
✅ Access to FluentCRM API (your WordPress domain)
✅ Cursor with MCP support
✅ API Key from FluentCRM (generate in Settings → Rest API)
Installation
Step 1: Clone repository or copy files
cd /path/to/your/fluentcrm-mcp-serverStep 2: Install dependencies
npm installStep 3: Build TypeScript
npm run buildYou should see:
✅ dist/fluentcrm-mcp-server.js (compiled)Step 4: Test connection
export FLUENTCRM_API_USERNAME="your_username"
export FLUENTCRM_API_PASSWORD="your_password"
npm startYou should see:
🚀 FluentCRM MCP Server running on stdio
📡 API URL: https://your-domain.com/wp-json/fluent-crm/v2
👤 Username: your_usernamePress CTRL+C to stop.
Configuration
1. Get API Credentials from FluentCRM
Step by step:
Log in to WordPress:
https://your-domain.com/wp-adminGo to: FluentCRM → Settings → Managers
Click Add New Manager
Enter:
Name:
MCP Server(or something else)Role:
Subscriber(sufficient)Permissions: Check all FluentCRM permissions
Click Save Manager
Go to: FluentCRM → Settings → Rest API
Click Create New Key
Select the manager you just created
Click Confirm
Copy:
Username (API_USERNAME)
Application Password (API_PASSWORD)
2. Set environment variables
Option A: Edit .env file
# .env
FLUENTCRM_API_USERNAME=your_api_username
FLUENTCRM_API_PASSWORD=your_api_password
FLUENTCRM_API_URL=https://your-domain.com/wp-json/fluent-crm/v2Option B: Export from terminal
export FLUENTCRM_API_USERNAME="your_api_username"
export FLUENTCRM_API_PASSWORD="your_api_password"3. Cursor Configuration (MCP)
Open Cursor
Press
Cmd+Shift+P(macOS) orCtrl+Shift+P(Windows/Linux)Search for: "MCP settings" or "Preferences: Open MCP Settings"
Edit configuration file:
{
"mcpServers": {
"fluentcrm": {
"command": "node",
"args": [
"/path/to/your/fluentcrm-mcp-server/dist/fluentcrm-mcp-server.js"
],
"env": {
"FLUENTCRM_API_USERNAME": "your_api_username",
"FLUENTCRM_API_PASSWORD": "your_api_password",
"FLUENTCRM_API_URL": "https://your-domain.com/wp-json/fluent-crm/v2"
}
}
}
}Save and restart Cursor
Usage
After configuration, open chat in Cursor and start asking questions!
Simple questions:
Show me all tags in FluentCRMClaude will automatically use the MCP Server and return a list of tags.
Available Tools
👤 CONTACTS (Subscribers)
fluentcrm_list_contacts- Get list of contactsfluentcrm_get_contact- Get contact detailsfluentcrm_find_contact_by_email- Search by emailfluentcrm_create_contact- Create new contactfluentcrm_update_contact- Update contactfluentcrm_delete_contact- Delete contact
🏷️ TAGS
fluentcrm_list_tags- Get all tagsfluentcrm_create_tag- Create new tagfluentcrm_delete_tag- Delete tagfluentcrm_attach_tag_to_contact- Assign tag to contactfluentcrm_detach_tag_from_contact- Remove tag from contact
📋 LISTS
fluentcrm_list_lists- Get all listsfluentcrm_create_list- Create new listfluentcrm_delete_list- Delete listfluentcrm_attach_contact_to_list- Add contact to listfluentcrm_detach_contact_from_list- Remove contact from list
📧 CAMPAIGNS
fluentcrm_list_campaigns- Get campaignsfluentcrm_create_campaign- Create campaignfluentcrm_pause_campaign- Pause campaignfluentcrm_resume_campaign- Resume campaignfluentcrm_delete_campaign- Delete campaign
📨 EMAIL TEMPLATES
fluentcrm_list_email_templates- Get templatesfluentcrm_create_email_template- Create template
🤖 AUTOMATIONS
fluentcrm_list_automations- Get automations (funnels)fluentcrm_create_automation- Create automation
🔗 WEBHOOKS
fluentcrm_list_webhooks- Get webhooksfluentcrm_create_webhook- Create webhook
📊 REPORTS
fluentcrm_dashboard_stats- Dashboard statisticsfluentcrm_custom_fields- Custom fields
Examples
Example 1: Show all tags
In Cursor:
Show me all tags in FluentCRMClaude will return:
✅ Fetching tags from FluentCRM...
Found the following tags:
1. registered (ID: 1)
2. webinar-jit (ID: 2)
3. progress-75 (ID: 3)
4. participated (ID: 4)
... and 47 moreExample 2: Create new tag
In Cursor:
Create tag "hot-lead" with description "People who watched 75%+ and are interested"Claude automatically:
Uses
fluentcrm_create_tagtoolReturns confirmation
Example 3: Assign tag to contact
In Cursor:
Assign tag "progress-75" to contact with email "jan@example.com"Claude:
Finds contact by email
Assigns tag
Returns confirmation
Example 4: Create list
In Cursor:
Create new list "Hot-leads" with description "Participants who watched 75%+ of webinar"Claude creates the list
Example 5: Add contact to list
In Cursor:
Add all contacts with tag "progress-75" to list "Hot-leads"Troubleshooting
❌ Error: "Authorization failed"
Cause: Wrong API Username or Password
Solution:
Go to FluentCRM → Settings → Rest API
Check if API Key is active
Copy credentials again
Update
.envfile
❌ Error: "Connection refused"
Cause: FluentCRM API unavailable
Solution:
Check if your WordPress domain is accessible
Ping:
ping your-domain.comCheck if WordPress is running
❌ MCP Server won't start
Cause: Missing dependencies
Solution:
npm install
npm run build❌ Cursor can't see MCP Server
Cause: Wrong file path or missing API credentials
Solution:
Check path in MCP configuration (
~/.cursor/settings.json)Check if file
dist/fluentcrm-mcp-server.jsexistsRestart Cursor
Check logs:
cat ~/.cursor/logs.txt
API Reference
FluentCRM API Documentation: https://rest-api.fluentcrm.com/#introduction
Security
⚠️ IMPORTANT:
❌ NEVER commit
.envwith real credentials to git❌ NEVER share API keys publicly
✅ Use environment variables instead of hardcoding
✅ Regularly rotate API keys
Update
To update MCP Server:
cd fluentcrm-mcp-server
git pull # or download latest version manually
npm install
npm run buildRestart Cursor.
Support
If you encounter problems:
Check the Troubleshooting section
Check FluentCRM logs: FluentCRM → Logs
Check Cursor logs:
~/.cursor/logs.txtContact support
License
MIT
Author
Miłosz Zając
🌐 www.netfly.pl
Date: 2025-01-20
Version: 1.0.0
Made with ❤️ by Miłosz Zając
Available Tools
36 toolsfluentcrm_attach_contact_to_listC
Przypisuje kontakt do listy
Inputs: subscriberId (required), listIds (required).
fluentcrm_attach_tag_to_contactC
Przypisuje tag do kontaktu
Inputs: subscriberId (required), tagIds (required).
fluentcrm_create_automationD
Tworzy nową automatyzację
Inputs: title (required), trigger (required), description.
fluentcrm_create_campaignC
Tworzy nową kampanię email
Inputs: title (required), subject (required), template_id, recipient_list.
fluentcrm_create_contactC
Tworzy nowy kontakt w FluentCRM
Inputs: email (required), first_name, last_name, phone, +3 more.
fluentcrm_create_email_templateC
Tworzy nowy szablon email
Inputs: title (required), subject (required), body (required).
fluentcrm_create_listC
Tworzy nową listę w FluentCRM
Inputs: title (required), slug, description.
fluentcrm_create_smart_linkC
Tworzy nowy Smart Link (może nie być dostępne w obecnej wersji)
Inputs: title (required), target_url (required), slug, apply_tags, +4 more.
fluentcrm_create_tagC
Tworzy nowy tag w FluentCRM
Inputs: title (required), slug, description.
fluentcrm_create_webhookD
Tworzy nowy webhook
Inputs: name (required), url (required), status (required), tags, +1 more.
fluentcrm_custom_fieldsC
Pobiera pola niestandardowe
Inputs: no named parameters.
fluentcrm_dashboard_statsC
Pobiera statystyki dashboarda
Inputs: no named parameters.
fluentcrm_delete_campaignC
Usuwa kampanię
Inputs: campaignId (required).
fluentcrm_delete_contactC
Usuwa kontakt z FluentCRM
Inputs: subscriberId (required).
fluentcrm_delete_listC
Usuwa listę z FluentCRM
Inputs: listId (required).
fluentcrm_delete_smart_linkC
Usuwa Smart Link (może nie być dostępne w obecnej wersji)
Inputs: smartLinkId (required).
fluentcrm_delete_tagC
Usuwa tag z FluentCRM
Inputs: tagId (required).
fluentcrm_detach_contact_from_listC
Usuwa kontakt z listy
Inputs: subscriberId (required), listIds (required).
fluentcrm_detach_tag_from_contactC
Usuwa tag z kontaktu
Inputs: subscriberId (required), tagIds (required).
fluentcrm_find_contact_by_emailC
Wyszukuje kontakt po adresie email
Inputs: email (required).
fluentcrm_generate_smart_link_shortcodeC
Generuje shortcode dla Smart Link
Inputs: slug (required), linkText.
fluentcrm_get_contactC
Pobiera szczegóły konkretnego kontaktu
Inputs: subscriberId (required).
fluentcrm_get_smart_linkC
Pobiera szczegóły konkretnego Smart Link
Inputs: smartLinkId (required).
fluentcrm_list_automationsC
Pobiera automatyzacje (funnels)
Inputs: page, search.
fluentcrm_list_campaignsC
Pobiera listę kampanii email
Inputs: page, search.
fluentcrm_list_contactsC
Pobiera listę wszystkich kontaktów z FluentCRM
Inputs: page, per_page, search.
fluentcrm_list_email_templatesB
Pobiera szablony email
Inputs: no named parameters.
fluentcrm_list_listsB
Pobiera wszystkie listy z FluentCRM
Inputs: no named parameters.
fluentcrm_list_smart_linksC
Pobiera listę Smart Links z FluentCRM (może nie być dostępne w obecnej wersji)
Inputs: page, search.
fluentcrm_list_tagsC
Pobiera wszystkie tagi z FluentCRM
Inputs: page, search.
fluentcrm_list_webhooksC
Pobiera webhooks
Inputs: no named parameters.
fluentcrm_pause_campaignD
Wstrzymuje kampanię
Inputs: campaignId (required).
fluentcrm_resume_campaignC
Wznawia kampanię
Inputs: campaignId (required).
fluentcrm_update_contactC
Aktualizuje dane kontaktu
Inputs: subscriberId (required), first_name, last_name, phone.
fluentcrm_update_smart_linkD
Aktualizuje Smart Link (może nie być dostępne w obecnej wersji)
Inputs: smartLinkId (required), title, target_url, apply_tags, +4 more.
fluentcrm_validate_smart_link_dataC
Waliduje dane Smart Link przed utworzeniem
Inputs: title (required), target_url (required), slug, apply_tags, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 36 tools
Most tools have distinct purposes targeting specific resources and actions, with clear boundaries between operations like create/delete/list/update. However, some potential ambiguity exists between 'fluentcrm_find_contact_by_email' and 'fluentcrm_get_contact' as both retrieve contact details, though the former specifies email search while the latter likely uses ID. The 'fluentcrm_custom_fields' tool also stands out as a read-only operation amidst mostly CRUD tools, but descriptions clarify its purpose.
All tools follow a highly consistent 'fluentcrm_verb_noun' pattern with snake_case throughout. The verb choices are logical and predictable (create, delete, list, get, update, attach, detach, etc.), making the tool set easy to navigate and understand at a glance. No deviations in naming conventions are present.
With 36 tools, the count is excessive for a CRM server, creating cognitive overhead and potential redundancy. While the domain is broad, many tools could be consolidated (e.g., separate attach/detach for lists and tags might be combined, or campaign pause/resume could be a single toggle). This volume suggests over-engineering rather than a well-scoped surface.
The tool set provides comprehensive coverage for FluentCRM's domain, including full CRUD operations for core resources (contacts, lists, tags, campaigns, templates, webhooks, automations), plus additional utilities like dashboard stats, custom fields, and smart link management. There are no obvious gaps; agents can perform end-to-end workflows from contact creation to campaign management.
Related MCP Connectors
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Manage your WordPress site from your AI assistant: posts, pages, media, comments and WooCommerce.
Operate the Plixana CRM from any AI: contacts, deals, quotes, WhatsApp and metrics.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables Claude to manage Systeme.io accounts, including contacts, tags, courses, and subscriptions, through natural language.183MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude to manage GoHighLevel CRM contacts, pipelines, and workflows through natural language commands.70 npmMIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude Code with GoHighLevel CRM to manage contacts, pipelines, calendars, conversations, workflows, funnels, and forms via natural language.MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude Desktop to interact with the BusinessFlowPro marketing automation platform via natural language, supporting campaign, contact, template, landing page, form, analytics, and AI content operations.MIT