FluentCRM

This MCP Server enables FluentCRM to be controlled directly from Cursor using the Model Context Protocol. You can manage contacts, tags, lists, campaigns, automations, webhooks, and reports from conversations with Claude, without leaving your chat.

How to use

After you configure Cursor to talk to the MCP server, you can perform common FluentCRM tasks right from chat. Ask Claude to fetch data, create entities, or run actions across your FluentCRM instance. For example, you can list all tags, create a new tag, assign a tag to a contact, or start a campaign. Each command maps to a specific MCP tool under the FluentCRM namespace and runs securely against your FluentCRM API.

How to install

Prerequisites: Node.js 18 or newer and npm or yarn, plus access to FluentCRM on your WordPress site. You also need a FluentCRM API key generated for MCP access.

# 1) Install dependencies
npm install

# 2) Build the TypeScript project
npm run build

# 3) Start the MCP server (test connection)
export FLUENTCRM_API_USERNAME="your_api_username"
export FLUENTCRM_API_PASSWORD="your_api_password"
export FLUENTCRM_API_URL="https://your-domain.com/wp-json/fluent-crm/v2"
npm start
```}]} ,{

Configuration and usage notes

Set up API credentials in FluentCRM and connect them to your MCP client as shown in the example configuration. You’ll provide the API username, password, and the FluentCRM API URL to the MCP server environment. The MCP server runs locally or on a server and exposes your FluentCRM data to Cursor via MCP.

{
  "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"
      }
    }
  }
}
```}]} ,{

Security and maintenance

Keep API credentials confidential. Do not commit .env files containing real credentials. Rotate keys regularly and use environment variables for all sensitive data. Monitor FluentCRM and MCP server logs for unusual activity and errors, and restart the MCP server if needed after configuration changes.

Troubleshooting

If the MCP server cannot start or cannot reach FluentCRM, verify that the API URL is reachable, the API credentials are correct, and the server process has permission to access Node modules and the compiled dist files.

# Example checks you can perform
ping your-domain.com
curl -I https://your-domain.com/wp-json/fluent-crm/v2
ls -l dist/fluentcrm-mcp-server.js
ps aux | grep fluentcrm-mcp-server
````}]} ,{

Examples

Common tasks you can perform include listing tags, creating a tag, attaching a tag to a contact, listing lists, creating a campaign, and fetching dashboard stats.

Available tools

fluentcrm_list_contacts

Get a list of contacts in FluentCRM

fluentcrm_get_contact

Retrieve details for a specific contact

fluentcrm_find_contact_by_email

Search for a contact by email address

fluentcrm_create_contact

Create a new contact in FluentCRM

fluentcrm_update_contact

Update an existing contact

fluentcrm_delete_contact

Delete a contact

fluentcrm_list_tags

Get all tags in FluentCRM

fluentcrm_create_tag

Create a new tag

fluentcrm_delete_tag

Delete a tag

fluentcrm_attach_tag_to_contact

Attach a tag to a contact

fluentcrm_detach_tag_from_contact

Remove a tag from a contact

fluentcrm_list_lists

Get all lists

fluentcrm_create_list

Create a new list

fluentcrm_delete_list

Delete a list

fluentcrm_attach_contact_to_list

Add a contact to a list

fluentcrm_detach_contact_from_list

Remove a contact from a list

fluentcrm_list_campaigns

Get campaigns

fluentcrm_create_campaign

Create a new campaign

fluentcrm_pause_campaign

Pause a campaign

fluentcrm_resume_campaign

Resume a campaign

fluentcrm_delete_campaign

Delete a campaign

fluentcrm_list_email_templates

Get email templates

fluentcrm_create_email_template

Create an email template

fluentcrm_list_automations

Get automations (funnels)

fluentcrm_create_automation

Create an automation

fluentcrm_list_webhooks

Get webhooks

fluentcrm_create_webhook

Create a webhook

fluentcrm_dashboard_stats

Dashboard statistics