ClickFunnels

by illgatesmusic

Not rated
GitHub

About

Integrates with ClickFunnels marketing platform to provide tools for listing and retrieving funnels, managing contacts, and debugging API connections through a modular TypeScript architecture.

Details

Author
illgatesmusic
Repository
illGATESmusic/click-funnels-mcp-shared
Categories
Design, Developer Tools, Infrastructure, Frontend, API

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name ClickFunnels
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 /absolute/path/to/click-funnels-mcp-shared/dist/index.js
    Environment
    • PORT 3002
    • NODE_ENV production
    • MCP_LOG_DIR /absolute/path/to/click-funnels-mcp-shared/logs
    • NODE_OPTIONS --max-old-space-size=256
    • MCP_LOG_LEVEL debug
    • MCP_LOG_TO_FILE true
    • MCP_LOG_TO_CONSOLE true
    • CLICKFUNNELS_API_BASE https://your-domain.myclickfunnels.com/api/v2
    • CLICKFUNNELS_API_TOKEN YOUR_API_TOKEN_HERE
    • CLICKFUNNELS_WORKSPACE_ID 123456
    • CLICKFUNNELS_WORKSPACE_SUBDOMAIN your-subdomain

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Clone this repository:

git clone https://github.com/illGATESmusic/click-funnels-mcp-shared.git
cd click-funnels-mcp-shared

2. Install dependencies:

npm install

3. Update the .env file with your ClickFunnels API credentials:

PORT=3002
CLICKFUNNELS_API_BASE=https://your-domain.myclickfunnels.com/api/v2
CLICKFUNNELS_WORKSPACE_ID=123456
CLICKFUNNELS_API_TOKEN=YOUR_API_TOKEN_HERE
CLICKFUNNELS_WORKSPACE_SUBDOMAIN=your-subdomain
NODE_ENV=production

4. Build the project:

npm run build

5. Update your Claude Desktop config:

Edit your Claude Desktop config file (located at ~/Library/Application Support/Claude/claude_desktop_config.json on Mac or appropriate location for your OS) to include this server:

{
  "mcpServers": {
    "clickfunnels-mcp-framework": {
      "command": "node",
      "args": ["/absolute/path/to/click-funnels-mcp-shared/dist/index.js"],
      "env": {
        "PORT": "3002",
        "CLICKFUNNELS_API_BASE": "https://your-domain.myclickfunnels.com/api/v2",
        "CLICKFUNNELS_WORKSPACE_ID": "123456",
        "CLICKFUNNELS_API_TOKEN": "YOUR_API_TOKEN_HERE",
        "CLICKFUNNELS_WORKSPACE_SUBDOMAIN": "your-subdomain",
        "NODE_ENV": "production",
        "MCP_LOG_LEVEL": "debug",
        "MCP_LOG_TO_CONSOLE": "true",
        "MCP_LOG_TO_FILE": "true",
        "MCP_LOG_DIR": "/absolute/path/to/click-funnels-mcp-shared/logs",
        "NODE_OPTIONS": "--max-old-space-size=256"
      },
      "cwd": "/absolute/path/to/click-funnels-mcp-shared"
    }
  },
  "mcpServerConnections": [
    {
      "url": "http://localhost:3002/sse"
    }
  ]
}

6. Restart Claude Desktop to apply the changes.

debug

Provides debugging information about the current environment.

list_funnels

Lists all funnels from your ClickFunnels account.

get_funnel

Gets a specific funnel by ID.

list_contacts

Lists contacts from your ClickFunnels account.

This MCP server provides the following tools:

- debug - Provides debugging information about the current environment
- list_funnels - Lists all funnels from your ClickFunnels account
- get_funnel - Gets a specific funnel by ID
- list_contacts - Lists contacts from your ClickFunnels account

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "clickfunnels": {
            "cwd": "/absolute/path/to/click-funnels-mcp-shared",
            "env": {
                "PORT": "3002",
                "NODE_ENV": "production",
                "MCP_LOG_DIR": "/absolute/path/to/click-funnels-mcp-shared/logs",
                "NODE_OPTIONS": "--max-old-space-size=256",
                "MCP_LOG_LEVEL": "debug",
                "MCP_LOG_TO_FILE": "true",
                "MCP_LOG_TO_CONSOLE": "true",
                "CLICKFUNNELS_API_BASE": "https://your-domain.myclickfunnels.com/api/v2",
                "CLICKFUNNELS_API_TOKEN": "YOUR_API_TOKEN_HERE",
                "CLICKFUNNELS_WORKSPACE_ID": "123456",
                "CLICKFUNNELS_WORKSPACE_SUBDOMAIN": "your-subdomain"
            },
            "args": [
                "/absolute/path/to/click-funnels-mcp-shared/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "cwd": "/absolute/path/to/click-funnels-mcp-shared",
    "env": {
        "PORT": "3002",
        "NODE_ENV": "production",
        "MCP_LOG_DIR": "/absolute/path/to/click-funnels-mcp-shared/logs",
        "NODE_OPTIONS": "--max-old-space-size=256",
        "MCP_LOG_LEVEL": "debug",
        "MCP_LOG_TO_FILE": "true",
        "MCP_LOG_TO_CONSOLE": "true",
        "CLICKFUNNELS_API_BASE": "https://your-domain.myclickfunnels.com/api/v2",
        "CLICKFUNNELS_API_TOKEN": "YOUR_API_TOKEN_HERE",
        "CLICKFUNNELS_WORKSPACE_ID": "123456",
        "CLICKFUNNELS_WORKSPACE_SUBDOMAIN": "your-subdomain"
    },
    "args": [
        "/absolute/path/to/click-funnels-mcp-shared/dist/index.js"
    ],
    "command": "node"
}

Macos

{
    "cwd": "/absolute/path/to/click-funnels-mcp-shared",
    "env": {
        "PORT": "3002",
        "NODE_ENV": "production",
        "MCP_LOG_DIR": "/absolute/path/to/click-funnels-mcp-shared/logs",
        "NODE_OPTIONS": "--max-old-space-size=256",
        "MCP_LOG_LEVEL": "debug",
        "MCP_LOG_TO_FILE": "true",
        "MCP_LOG_TO_CONSOLE": "true",
        "CLICKFUNNELS_API_BASE": "https://your-domain.myclickfunnels.com/api/v2",
        "CLICKFUNNELS_API_TOKEN": "YOUR_API_TOKEN_HERE",
        "CLICKFUNNELS_WORKSPACE_ID": "123456",
        "CLICKFUNNELS_WORKSPACE_SUBDOMAIN": "your-subdomain"
    },
    "args": [
        "/absolute/path/to/click-funnels-mcp-shared/dist/index.js"
    ],
    "command": "node"
}

Windows

{
    "cwd": "/absolute/path/to/click-funnels-mcp-shared",
    "env": {
        "PORT": "3002",
        "NODE_ENV": "production",
        "MCP_LOG_DIR": "/absolute/path/to/click-funnels-mcp-shared/logs",
        "NODE_OPTIONS": "--max-old-space-size=256",
        "MCP_LOG_LEVEL": "debug",
        "MCP_LOG_TO_FILE": "true",
        "MCP_LOG_TO_CONSOLE": "true",
        "CLICKFUNNELS_API_BASE": "https://your-domain.myclickfunnels.com/api/v2",
        "CLICKFUNNELS_API_TOKEN": "YOUR_API_TOKEN_HERE",
        "CLICKFUNNELS_WORKSPACE_ID": "123456",
        "CLICKFUNNELS_WORKSPACE_SUBDOMAIN": "your-subdomain"
    },
    "args": [
        "/absolute/path/to/click-funnels-mcp-shared/dist/index.js"
    ],
    "command": "node"
}

ClickFunnels MCP Framework

This is a Model Context Protocol (MCP) server for integrating ClickFunnels with Claude Desktop.

Setup Instructions

1. Clone this repository:

git clone https://github.com/illGATESmusic/click-funnels-mcp-shared.git
cd click-funnels-mcp-shared

2. Install dependencies:

npm install

3. Update the .env file with your ClickFunnels API credentials:

PORT=3002
CLICKFUNNELS_API_BASE=https://your-domain.myclickfunnels.com/api/v2
CLICKFUNNELS_WORKSPACE_ID=123456
CLICKFUNNELS_API_TOKEN=YOUR_API_TOKEN_HERE
CLICKFUNNELS_WORKSPACE_SUBDOMAIN=your-subdomain
NODE_ENV=production

4. Build the project:

npm run build

5. Update your Claude Desktop config:

Edit your Claude Desktop config file (located at ~/Library/Application Support/Claude/claude_desktop_config.json on Mac or appropriate location for your OS) to include this server:

{
  "mcpServers": {
    "clickfunnels-mcp-framework": {
      "command": "node",
      "args": ["/absolute/path/to/click-funnels-mcp-shared/dist/index.js"],
      "env": {
        "PORT": "3002",
        "CLICKFUNNELS_API_BASE": "https://your-domain.myclickfunnels.com/api/v2",
        "CLICKFUNNELS_WORKSPACE_ID": "123456",
        "CLICKFUNNELS_API_TOKEN": "YOUR_API_TOKEN_HERE",
        "CLICKFUNNELS_WORKSPACE_SUBDOMAIN": "your-subdomain",
        "NODE_ENV": "production",
        "MCP_LOG_LEVEL": "debug",
        "MCP_LOG_TO_CONSOLE": "true",
        "MCP_LOG_TO_FILE": "true",
        "MCP_LOG_DIR": "/absolute/path/to/click-funnels-mcp-shared/logs",
        "NODE_OPTIONS": "--max-old-space-size=256"
      },
      "cwd": "/absolute/path/to/click-funnels-mcp-shared"
    }
  },
  "mcpServerConnections": [
    {
      "url": "http://localhost:3002/sse"
    }
  ]
}

6. Restart Claude Desktop to apply the changes.

Troubleshooting

If you encounter any issues, check the logs at:
- /Users/username/Library/Logs/Claude/mcp-server-clickfunnels-mcp-framework.log

Common issues:

1. "No such file or directory" error:
- Make sure all required directories exist (logs, tools, prompts, resources)
- Ensure the path in claude_desktop_config.json matches the absolute path to your server
- The "cwd" field in the configuration is critical for proper path resolution

2. Server disconnects immediately:
- Check that you're using the correct server name in the configuration
- Verify all environment variables are correctly set
- Make sure logs directory exists and is writable

3. API connection errors:
- Verify your ClickFunnels API credentials are correct
- Check if you've reached any API rate limits

If all else fails, run the TROUBLESHOOTING.md script to collect diagnostic information.

Available Tools

This MCP server provides the following tools:

- debug - Provides debugging information about the current environment
- list_funnels - Lists all funnels from your ClickFunnels account
- get_funnel - Gets a specific funnel by ID
- list_contacts - Lists contacts from your ClickFunnels account

Contributing

If you encounter any issues or have suggestions, please open an issue or submit a pull request.

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.