GoHighLevel + Claude Code: Run Agentic AI Workflows Directly Inside Your CRM

TLDR

• GoHighLevel has an official MCP server that exposes your CRM data to any AI agent via standard HTTP
• Claude Code auto-discovers MCP servers and can operate your GHL account using plain English commands
• A community-built extension brings the tool count to 461+, covering contacts, conversations, pipelines, invoices, social media and e-commerce
• You can query contacts, send messages, trigger automations, book appointments and pull pipeline reports without opening the dashboard
• The setup requires a Private Integration Token (PIT) - not a regular API key
• This is not a chatbot. Claude Code executes multi-step CRM tasks end to end, with full context from your sub-account
• Agencies can wrap this setup into a productized AI operations offer for clients

Who This Is For

• Agency owners who already use GoHighLevel and want to operate it faster using AI
• Developers or technical freelancers building custom GHL automations for clients
• SaaS resellers who want to differentiate their offer with genuine AI-first operations
• Anyone who finds themselves clicking through GHL dashboards for tasks that should be automated

The Problem: Dashboards Were Not Built for AI Speed

GoHighLevel is powerful. But it is still a dashboard.

You click to find contacts. You navigate to trigger a workflow. You open pipelines to update a stage.

For repetitive operational tasks - tagging leads, drafting follow-ups, checking pipeline gaps, bulk-updating contacts after a campaign - the dashboard creates friction.

The MCP (Model Context Protocol) layer removes that friction entirely.

Instead of navigating, you describe the task in plain language. Claude Code executes it.

What Is the GoHighLevel MCP Server

MCP stands for Model Context Protocol. It is an open standard that lets AI agents query and modify external systems using structured tool calls over HTTP.

GoHighLevel launched its official hosted MCP server in late 2025:

https://services.leadconnectorhq.com/mcp/

It exposes your sub-account data - contacts, conversations, calendars, pipelines, payments, workflows - to any MCP-compatible AI client.

The official server currently supports 21 tools.

A community-built extension (originally by mastanley13, extended by BusyBee3333) expands this to 461+ tools across 19 categories, covering the complete GHL API surface.

What Is Claude Code

Claude Code is Anthropic's agentic coding tool. It runs in your terminal, operates files, executes bash commands, calls APIs and reasons across multi-step tasks.

Critically: Claude Code auto-discovers MCP servers.

Run a GHL MCP server in your project directory, and Claude Code finds it without any extra configuration. You can then address your entire GoHighLevel sub-account using natural language from the command line.

This is different from Claude Desktop (which requires manual JSON config) and different from Zapier or Make (which require pre-built templates).

Claude Code understands context. It can chain operations. It handles conditional logic. It works like a developer-level operator for your CRM.

What You Can Do With GHL + Claude Code

Here are practical operations that work out of the box once the MCP is connected:

Contact and Lead Management

• "Find all contacts tagged 'cold-lead' who haven't been contacted in 30 days"
• "Add a note to every contact in the 'Proposal Sent' pipeline stage"
• "Tag all contacts who opened the last email campaign but didn't click"
• "Create 50 contacts from this CSV and assign them to the 'New Inquiry' pipeline"

Conversations and Messaging

• "Draft a follow-up SMS for all leads who filled out the form this week"
• "Summarize the last 10 conversations in my Appointments pipeline"
• "Flag any conversation where the word 'refund' or 'cancel' appears"

Pipelines and Opportunities

• "Show me all opportunities stuck in 'Proposal Sent' for more than 7 days"
• "Move all opportunities with no activity in 14 days to 'At Risk' stage"
• "Build a pipeline report: total value by stage, this month vs last month"

Appointments and Calendars

• "Book an appointment for contact [name] for next Thursday at 2 PM"
• "List all appointments for this week with no pre-call reminder sent"
• "Reschedule all appointments from [date] to the following week"

Workflows and Automations

• "Show me which workflows are currently active and how many contacts are in each"
• "Trigger the 'Re-engagement Sequence' for all contacts tagged 'inactive-60d'"

Payments and Invoices

• "Generate an invoice for [contact] for $1,500 - service: Monthly Retainer"
• "List all unpaid invoices older than 14 days"

Setup: Connecting Claude Code to GoHighLevel MCP

Option 1 - Official GHL MCP Server (21 tools, simplest)

Step 1 - Create a Private Integration Token

In GoHighLevel go to: Settings → Private Integrations → Create New Integration

Select the scopes your workflow needs:

• Contacts (read/write)
• Conversations (read/write)
• Calendars (read/write)
• Opportunities (read/write)
• Payments (read only unless billing is needed)
• Workflows (read)

Copy the token. This is your PIT. Do not use a regular API key - the MCP requires a PIT specifically.

Step 2 - Get your Location ID

Go to Settings → Company → Locations. Copy the Location ID for the sub-account you are connecting.

Step 3 - Configure Claude Code

In your project directory, create or update .claude/mcp.json:

json

{
  "mcpServers": {
    "ghl": {
      "url": "https://services.leadconnectorhq.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_PIT_TOKEN",
        "locationId": "YOUR_LOCATION_ID"
      }
    }
  }
}

Restart Claude Code. Type @ghl to address the server directly.

Step 4 - Test

Run: @ghl list my contacts added in the last 7 days

If you get a contact list back, the connection is live.

Option 2 - Community MCP Server (461+ tools, full API coverage)

For agencies who need complete access - invoices, email campaigns, blog management, social media, e-commerce, custom objects - the community server is the better option.

Step 1 - Clone and configure

bash

git clone https://github.com/mastanley13/GoHighLevel-MCP.git
cd GoHighLevel-MCP
npm install
cp .env.example .env

Edit .env:

GHL_API_KEY=your_private_integrations_api_key
GHL_BASE_URL=https://services.leadconnectorhq.com
GHL_LOCATION_ID=your_location_id

Step 2 - Build and start

bash

npm run build
npm start

Step 3 - Configure Claude Code

json

{
  "mcpServers": {
    "ghl_full": {
      "command": "node",
      "args": ["path/to/GoHighLevel-MCP/dist/server.js"],
      "env": {
        "GHL_API_KEY": "your_key",
        "GHL_BASE_URL": "https://services.leadconnectorhq.com",
        "GHL_LOCATION_ID": "your_location_id"
      }
    }
  }
}

Claude Code uses stdio protocol natively - no additional bridge needed.

Tool Coverage Comparison

What GHL Is Adding to MCP (Roadmap)

GoHighLevel's official MCP roadmap includes:

• Expansion to 250+ tools across all GHL modules
• npx package for clients without native HTTP support (including Claude Desktop)
• OAuth support for multi-account authorization flows

The community server already provides most of this today. The official server will eventually replace it for most use cases.

Agency Revenue Model: AI Operations as a Service

Once you have Claude Code wired to GHL, you have a billable service.

What to Charge

Breakeven

At $297/mo for a GHL Unlimited account and $0 additional cost for Claude Code (included in your Anthropic usage), a single AI operations client at $500/mo puts you in profit before you touch anything else.

For agencies already running GHL for 5–10 clients, this is an upsell that requires no new infrastructure.

Security and Scope Control

Scope your PIT precisely.

Only grant the permissions your workflow actually needs. If Claude Code is running contact management tasks, it does not need payment write access.

Rate limiting applies.

GHL API has rate limits per sub-account. For bulk operations (large contact lists, mass tagging), structure your Claude Code prompts to batch in groups of 50–100.

Never share PITs in code repositories.

Use environment variables. Add .env to .gitignore before first commit.

Test in a staging sub-account first.

Create a test sub-account in your GHL agency dashboard. Run all new Claude Code operations against that account before touching live client data.

Internal Links

How to Use the HighLevel MCP Server - AI-Powered GoHighLevel Workflows

GoHighLevel AI Employee 2025 - The Complete SOP for Agencies and Businesses

HighLevel AI Agent Studio - The Ultimate Automation Game-Changer for Agencies

Mastering GoHighLevel Automation - Complete 2025 Beginner to Expert Setup Guide

FAQ

What is the GoHighLevel MCP server? The GoHighLevel MCP server is a hosted HTTP endpoint that lets AI agents like Claude Code query and modify your CRM data using the Model Context Protocol. It is available at https://services.leadconnectorhq.com/mcp/ and requires a Private Integration Token for authentication.

Does Claude Code work with GoHighLevel without extra setup? Claude Code auto-discovers MCP servers defined in your project config. Once you add the GHL MCP configuration to your .claude/mcp.json file and restart, Claude Code can address your GoHighLevel sub-account directly using the @ghl syntax.

What is the difference between the official GHL MCP and the community MCP server? The official GHL MCP supports 21 tools covering core CRM functions. The community server (maintained by mastanley13 and extended by BusyBee3333) exposes 461+ tools covering the full GHL API including invoices, social media, email campaigns, blog management and e-commerce. The community server uses stdio protocol, which Claude Code supports natively.

Is this the same as using Claude Desktop with GoHighLevel? No. Claude Desktop requires an npx package (currently on the GHL roadmap but not yet released for the official server). Claude Code uses stdio MCP natively and works today with the community server. They solve different use cases - Claude Desktop is conversational, Claude Code is agentic and executes multi-step tasks end to end.

What is a Private Integration Token and where do I get one? A PIT is a scoped API credential specific to GoHighLevel's Private Integrations system. Go to Settings → Private Integrations → Create New Integration in your GHL dashboard. You select the permission scopes and copy the generated token. Standard API keys do not work with the MCP server.

Can I use this setup to manage multiple client sub-accounts? Yes, but each sub-account requires its own PIT and Location ID. You can configure multiple MCP server instances in Claude Code - one per client. For agencies managing 10+ accounts, consider scripting the configuration generation from a master credentials file.

Is this safe to use with live client data? With correct scope control, yes. Only grant the permissions your workflow requires. Always test new operations in a staging sub-account first. Never store PITs in version control. The GHL API enforces rate limits, which prevents accidental bulk operations from running uncontrolled.

What does GoHighLevel's MCP roadmap include? GHL has confirmed expansion to 250+ tools, an npx package for clients without native HTTP support (including Claude Desktop), and OAuth support for advanced authorization. Timeline has not been specified but the community server already covers most of this functionality.

Already using GoHighLevel's built-in AI? Read the full breakdown of what GoHighLevel AI Employee can automate for your agency before adding external tools.

✅ HighLevel 30-Day Free Trial

Claim Your Free Month

GoHighLevel includes the MCP server on all plans. The 30-day trial gives you enough time to build, test and validate your Claude Code integration before committing.

What's New in GoHighLevel