Skip to main content
Glama

🚀 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-server

Step 2: Install dependencies

npm install

Step 3: Build TypeScript

npm run build

You 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 start

You should see:

🚀 FluentCRM MCP Server running on stdio
📡 API URL: https://your-domain.com/wp-json/fluent-crm/v2
👤 Username: your_username

Press CTRL+C to stop.


Configuration

1. Get API Credentials from FluentCRM

Step by step:

  1. Log in to WordPress: https://your-domain.com/wp-admin

  2. Go to: FluentCRM → Settings → Managers

  3. Click Add New Manager

  4. Enter:

    • Name: MCP Server (or something else)

    • Role: Subscriber (sufficient)

    • Permissions: Check all FluentCRM permissions

  5. Click Save Manager

  6. Go to: FluentCRM → Settings → Rest API

  7. Click Create New Key

  8. Select the manager you just created

  9. Click Confirm

  10. 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/v2

Option B: Export from terminal

export FLUENTCRM_API_USERNAME="your_api_username"
export FLUENTCRM_API_PASSWORD="your_api_password"

3. Cursor Configuration (MCP)

  1. Open Cursor

  2. Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux)

  3. Search for: "MCP settings" or "Preferences: Open MCP Settings"

  4. 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"
      }
    }
  }
}
  1. Save and restart Cursor


Usage

After configuration, open chat in Cursor and start asking questions!

Simple questions:

Show me all tags in FluentCRM

Claude will automatically use the MCP Server and return a list of tags.


Available Tools

👤 CONTACTS (Subscribers)

  • fluentcrm_list_contacts - Get list of contacts

  • fluentcrm_get_contact - Get contact details

  • fluentcrm_find_contact_by_email - Search by email

  • fluentcrm_create_contact - Create new contact

  • fluentcrm_update_contact - Update contact

  • fluentcrm_delete_contact - Delete contact

🏷️ TAGS

  • fluentcrm_list_tags - Get all tags

  • fluentcrm_create_tag - Create new tag

  • fluentcrm_delete_tag - Delete tag

  • fluentcrm_attach_tag_to_contact - Assign tag to contact

  • fluentcrm_detach_tag_from_contact - Remove tag from contact

📋 LISTS

  • fluentcrm_list_lists - Get all lists

  • fluentcrm_create_list - Create new list

  • fluentcrm_delete_list - Delete list

  • fluentcrm_attach_contact_to_list - Add contact to list

  • fluentcrm_detach_contact_from_list - Remove contact from list

📧 CAMPAIGNS

  • fluentcrm_list_campaigns - Get campaigns

  • fluentcrm_create_campaign - Create campaign

  • fluentcrm_pause_campaign - Pause campaign

  • fluentcrm_resume_campaign - Resume campaign

  • fluentcrm_delete_campaign - Delete campaign

📨 EMAIL TEMPLATES

  • fluentcrm_list_email_templates - Get templates

  • fluentcrm_create_email_template - Create template

🤖 AUTOMATIONS

  • fluentcrm_list_automations - Get automations (funnels)

  • fluentcrm_create_automation - Create automation

🔗 WEBHOOKS

  • fluentcrm_list_webhooks - Get webhooks

  • fluentcrm_create_webhook - Create webhook

📊 REPORTS

  • fluentcrm_dashboard_stats - Dashboard statistics

  • fluentcrm_custom_fields - Custom fields


Examples

Example 1: Show all tags

In Cursor:

Show me all tags in FluentCRM

Claude 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 more

Example 2: Create new tag

In Cursor:

Create tag "hot-lead" with description "People who watched 75%+ and are interested"

Claude automatically:

  1. Uses fluentcrm_create_tag tool

  2. Returns confirmation

Example 3: Assign tag to contact

In Cursor:

Assign tag "progress-75" to contact with email "jan@example.com"

Claude:

  1. Finds contact by email

  2. Assigns tag

  3. 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:

  1. Go to FluentCRM → Settings → Rest API

  2. Check if API Key is active

  3. Copy credentials again

  4. Update .env file

❌ Error: "Connection refused"

Cause: FluentCRM API unavailable

Solution:

  1. Check if your WordPress domain is accessible

  2. Ping: ping your-domain.com

  3. Check 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:

  1. Check path in MCP configuration (~/.cursor/settings.json)

  2. Check if file dist/fluentcrm-mcp-server.js exists

  3. Restart Cursor

  4. Check logs: cat ~/.cursor/logs.txt


API Reference

FluentCRM API Documentation: https://rest-api.fluentcrm.com/#introduction


Security

⚠️ IMPORTANT:

  • ❌ NEVER commit .env with 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 build

Restart Cursor.


Support

If you encounter problems:

  1. Check the Troubleshooting section

  2. Check FluentCRM logs: FluentCRM → Logs

  3. Check Cursor logs: ~/.cursor/logs.txt

  4. Contact 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 tools
fluentcrm_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_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_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_get_contactC

Pobiera szczegóły konkretnego kontaktu

Inputs: subscriberId (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_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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 36 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables Claude to manage Systeme.io accounts, including contacts, tags, courses, and subscriptions, through natural language.
      18
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to manage GoHighLevel CRM contacts, pipelines, and workflows through natural language commands.
      70 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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