GoHighLevel MCP Server (Sub-Account)

Connect your GoHighLevel sub-account to Claude Code. Talk to your CRM, contacts, pipelines, calendars, invoices, and more — all from your terminal.

One-Command Install

git clone https://github.com/tenfoldmarc/ghl-mcp.git && cd ghl-mcp && bash install.sh

The installer will:

1. Create a Python virtual environment

2. Install dependencies

3. Ask for your Private Integration Token and Location ID

4. Register the MCP server with Claude Code

Restart Claude Code and you're live.

Related MCP server: ghl-mcp

Before You Install

You need two things from GoHighLevel:

1. Private Integration Token

1. Open your GHL Sub-Account (not the agency view)

2. Go to Settings → Integrations → Private Integrations

3. Click Create New

4. Name it (e.g. "Claude")

5. Select the scopes you need (recommended: select all read + write scopes)

6. Click Create and copy the token

2. Location ID

Look at your browser URL when inside the sub-account:

https://app.gohighlevel.com/v2/location/abc123xyz/dashboard
                                        ^^^^^^^^^
                                        This is your Location ID

What You Can Do

Once connected, just talk to Claude naturally:

• "Show me all contacts tagged VIP"

• "Create a contact for John Smith, john@example.com"

• "What deals are open in my pipeline?"

• "Send an SMS to contact xyz saying 'Your appointment is confirmed'"

• "List all my workflows"

• "Show me invoices from last month"

• "Create a blog post about..."

Full Tool List

Manual Setup (if you prefer)

# Clone and install
git clone https://github.com/tenfoldmarc/ghl-mcp.git
cd ghl-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

# Register with Claude Code
claude mcp add ghl \
    -e GHL_PRIVATE_TOKEN="your_token_here" \
    -e GHL_LOCATION_ID="your_location_id_here" \
    -- "$(pwd)/.venv/bin/python" "$(pwd)/main.py"

Then restart Claude Code.

Troubleshooting

"GHL_PRIVATE_TOKEN environment variable is not set" → Re-run the installer or check your MCP config with claude mcp list

HTTP 401 errors → Your token may be expired or invalid. Create a new Private Integration in GHL.

HTTP 403 on a specific tool → Your Private Integration is missing the required scope. Edit it in GHL and add the missing permission.

Tools not showing up → Make sure you restarted Claude Code after installing.

Requirements

• Python 3.10+

• Claude Code CLI

• A GoHighLevel sub-account with a Private Integration

Built by @tenfoldmarc — follow for more AI automation builds.