ghl-mcp

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.

---

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

| Category | Tools | |----------|-------| | Contacts | search, get, create, update, notes, tags | | Conversations | search, get messages, send (SMS/Email/WhatsApp) | | Pipelines & Deals | get pipelines, search/create/update/delete opportunities | | Calendar | list calendars, get/create/delete appointments | | Email Templates | list, get, create, update, delete | | Email Campaigns | list, get, create, update, schedule, send, delete | | Workflows | list, add contact to workflow | | Funnels | list funnels, list pages | | Forms & Surveys | list, get submissions | | Blog | list, create, update, delete posts | | Social Media | accounts, list/create/update/delete posts | | Products & Prices | full CRUD | | Invoices | list, create, send, void, record payment, delete | | Payments | orders, transactions, subscriptions | | Media Library | list/search files | | Businesses | full CRUD | | Custom Values | list, create, update, delete | | Trigger Links | list, create, update, delete | | Courses | list | | Drip Campaigns | list, add contact | | Users | list team members | | Custom Fields & Tags | 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.