Claude Code + GoHighLevel MCP: The Complete Guide for Coaches, Consultants, and Agency Owners

Nathan FieldNathan FieldFounder, Havstock12 min read
Illustration of a terminal running claude with a "GoHighLevel connected" card

The GoHighLevel MCP server lets Claude Code talk directly to your GoHighLevel account. No Zapier. No Make. No middleware. One connection, and your AI agent can pull contacts, update pipelines, trigger workflows, send messages, and manage your entire CRM through natural language commands.

This is not a theoretical integration. GoHighLevel officially launched their MCP server in early 2026, and Claude Code supports it natively. The result is an AI agent that understands your business data and can act on it: reading your pipeline, segmenting your contacts, drafting follow-ups, analyzing campaign performance, and automating the admin work that eats your day.

If you are running a coaching, consulting, or agency business on GoHighLevel (we may earn a commission from this link), this guide covers everything: what MCP is, how to set it up step by step, what you can actually do with it, and the specific workflows that save time and make money.

What is the GoHighLevel MCP?

The GoHighLevel MCP is GoHighLevel's own MCP server. It lets AI tools like Claude Code read and change data in your GoHighLevel account, from contacts and conversations to calendars, opportunities and payments. GoHighLevel's developer docs call it the LeadConnector MCP Server. MCP stands for Model Context Protocol, an open standard developed by Anthropic for plugging AI tools into other software.

GoHighLevel documents two versions, checked 12 October 2026:

OAuth version (newer)Token version
Address for Claudehttps://services.leadconnectorhq.com/mcp/anthropic/v2https://services.leadconnectorhq.com/mcp/
How you connectSign in to GoHighLevel in your browser, pick the sub-account and approve the scopesPaste a Private Integration Token and your location ID into your config
What the AI can reachMore than 550 operations across 38 areas, found and run through 4 tools36 listed tools for contacts, conversations, calendars, opportunities, payments, blogs, email templates and social posts
AgenciesOne connection across many sub-accounts is rolling outOne location ID per connection
SourceGoHighLevel developer docsGoHighLevel help article, modified 9 July 2026

For Claude Code, GoHighLevel's docs show the OAuth version as a short entry in a .mcp.json file at your project root:

{
  "mcpServers": {
    "leadconnector": {
      "type": "http",
      "url": "https://services.leadconnectorhq.com/mcp/anthropic/v2"
    }
  }
}

The first time you use it, Claude Code opens a browser so you can sign in and approve access. No token to copy. The steps below use the token version, which GoHighLevel's help center still documents.

Either way, the AI can only do what you allow. With OAuth, you approve scopes when you connect, and GoHighLevel says sensitive or irreversible actions get extra confirmation and safety checks. With a token, the scopes you tick decide it.

“MCP removes the middleware. Claude Code talks directly to GoHighLevel through a single, secure protocol you control.”

What You Need Before You Start

Before setting up the connection, make sure you have:

  • A GoHighLevel account (any plan works: Starter, Unlimited, or SaaS Mode)

  • Claude Code installed on your machine (or Claude Desktop with MCP support)

  • Your GoHighLevel Location ID (found in Settings > Business Profile)

  • Admin access to your GHL sub-account (you need to create Private Integrations)

No coding experience required. The entire setup takes under 10 minutes.

Step-by-Step Setup: Connecting Claude Code to GoHighLevel

Step 1: Create a Private Integration in GoHighLevel

Log into your GoHighLevel account. Navigate to Settings > Private Integrations > Create New Integration.

Name it something clear like "Claude Code MCP" so you know what it is later.

Step 2: Set Your Permissions

This is the most important step. Do not enable all permissions. Start with only what you need:

  • View Locations: lets Claude see your account info

  • View/Edit Contacts: lets Claude read and update your contact records

  • View Pipelines: lets Claude see your deal stages and opportunities

  • Edit Calendars: lets Claude manage appointment slots

  • View Conversations: lets Claude read message threads

  • View/Edit Tags: lets Claude segment your contacts

  • View Custom Fields: lets Claude read your custom data

You can always add more permissions later. Starting with a restricted set is better for security.

Step 3: Copy Your PIT Token and Location ID

After clicking Create, GoHighLevel will show your Private Integration Token (PIT). Copy it immediately. You only see it once. If you lose it, you will need to create a new integration.

Also copy your Location ID from Settings > Business Profile. You need both values for the next step.

Step 4: Configure Claude Code

Add the GoHighLevel MCP server to your Claude Code configuration. The config file is typically located at:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this to your MCP servers configuration:

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

Replace YOUR_PIT_TOKEN with the token you copied in Step 3, and YOUR_LOCATION_ID with your Location ID.

Step 5: Test the Connection

Restart Claude Code (or Claude Desktop), then ask it something simple like:

"How many contacts do I have in GoHighLevel?"

or

"Show me my active pipeline stages."

If it returns data from your GHL account, the connection is live.

“The entire setup takes under 10 minutes. No Zapier. No code. Just a direct connection between your AI and your CRM.”

What Claude Code Can Actually Do With GoHighLevel

Once connected, Claude Code has access to your GHL data through the MCP server's endpoints. Here is what that means in practice.

Contact Management

Ask Claude to pull up contacts by tag, segment, custom field value, or date range. Update contact records in bulk. Add or remove tags across hundreds of contacts in seconds instead of clicking through the UI one by one.

Example prompts:

  • "Tag all contacts who booked a discovery call in the last 30 days but did not convert as 'Warm Lead Reactivation'"

  • "How many contacts were added this week from my Facebook ad funnel?"

  • "Update the custom field 'Lead Source' to 'Webinar' for all contacts tagged 'April Webinar Attendee'"

For coaches running lead follow-up sequences, this means you can audit and clean your contact data with a single command instead of spending an hour in the GHL interface.

Pipeline and Opportunity Tracking

Claude can read your pipeline stages, count deals at each stage, calculate total pipeline value, and identify stalled opportunities.

Example prompts:

  • "How much total revenue is sitting in my 'Proposal Sent' stage right now?"

  • "Which deals have been in the 'Discovery Call Booked' stage for more than 7 days without moving?"

  • "Show me a breakdown of my pipeline by stage with deal count and total value"

This is pipeline intelligence that normally requires you to manually scan your pipeline board or export to a spreadsheet.

Calendar and Appointment Analysis

Claude can view your calendar data, check availability, and help you understand booking patterns.

Example prompts:

  • "How many discovery calls are booked for this week?"

  • "What is my no-show rate for the last 30 days?"

  • "Which days of the week get the most bookings?"

Conversation Intelligence

Claude can read your GHL conversations to help you draft responses, analyze response times, or identify leads that need attention.

Example prompts:

  • "Show me all unread conversations from the last 48 hours"

  • "Draft a follow-up message for contacts who messaged us but did not get a reply within 24 hours"

  • "What are the most common questions leads are asking in our inbox?"

Reporting and Analysis

This is where Claude Code becomes genuinely powerful. Instead of clicking through GHL's reporting dashboards, you can ask for specific insights in natural language.

Example prompts:

  • "Give me a weekly summary: new leads, booked calls, closed deals, and revenue"

  • "Compare this month's lead volume to last month by source"

  • "Which SMS automation campaign has the highest response rate?"

“Claude Code turns your GoHighLevel account into a conversational database. Ask questions in plain English, get answers in seconds.”

7 Workflows That Save Real Time

Knowing what Claude Code can do is one thing. Knowing how to use it to actually save time and make money is another. Here are seven workflows built specifically for coaching and consulting businesses.

1. Monday Morning Pipeline Review

Instead of manually scanning your pipeline every Monday, ask Claude:

"Give me a pipeline summary for this week. How many deals at each stage, total value per stage, and which deals have been stuck for more than 5 days?"

This replaces 20-30 minutes of manual pipeline scanning with a 10-second prompt.

2. Lead Quality Audit

"Pull all leads from the last 30 days. How many booked a call? How many showed up? How many converted? Break it down by lead source."

This is the kind of analysis most coaches never do because it takes too long. With Claude Code and GHL connected, it takes one prompt.

3. Stale Lead Reactivation Prep

"Find all contacts tagged 'Discovery Call No-Show' from the last 60 days who are not currently in an active workflow. Tag them 'Reactivation April' and give me a count."

Now trigger your reactivation workflow on that tag, and those leads re-enter your funnel automatically.

4. Weekly Client Report Generation

If you run an agency or manage GHL sub-accounts for clients, have Claude generate weekly performance reports:

"Create a report for Client X: new contacts added, calls booked, deals closed, pipeline value change, and top-performing traffic source. Format it for email."

What used to take 30 minutes of dashboard clicking now takes one prompt.

5. Contact Cleanup and Deduplication

"Find duplicate contacts based on email address. List them with their tags and pipeline stage so I can decide which to merge."

Dirty data kills automation. This workflow keeps your CRM clean without manual auditing.

6. Discovery Call Funnel Analysis

"How many people hit my discovery call funnel landing page this month? How many booked? What is the page-to-booking conversion rate?"

This connects your funnel performance to your calendar data, giving you a conversion metric most coaches never track.

7. End-of-Month Revenue Reconciliation

"Pull all deals marked 'Closed Won' this month. Total revenue, average deal size, and close rate compared to last month."

Done in seconds. No spreadsheet required.

The Official MCP Server vs Community MCP Servers

GoHighLevel's token MCP server lists 36 tools in its help article, covering contacts, conversations, calendars, opportunities, payments, blogs, email templates and social posts. Its newer OAuth MCP server reaches more than 550 operations, including invoices, the social planner and the media library (checked 12 October 2026).

Community-developed MCP servers (like the open-source version on GitHub) offer 269+ tools across 19 categories, including deeper access to invoices, payments, media library, social planner, and more.

For most coaches and consultants, the official MCP server covers everything you need. If you need something it does not cover, the community server is worth exploring. Just understand that it is community-maintained, not officially supported by GoHighLevel.

Security Best Practices

When you connect an AI agent to your CRM, security matters. Here is how to keep it tight:

Use minimum permissions. Only enable the scopes you actually need. You can always add more later. Do not enable "Edit" permissions until you are comfortable with "View" first.

Store your PIT token securely. Do not paste it in shared documents, Slack channels, or email. Treat it like a password.

Audit regularly. Check your Private Integrations page in GHL monthly. If you are not using a connection, delete it.

Do not share your Claude Code config file. It contains your API tokens. If you need to share your setup with a team member, create a separate integration for them with their own token and permissions.

“Treat your MCP connection like you treat your bank login. Minimum permissions, secure storage, regular audits.”

Common Setup Issues and Fixes

"Claude cannot see my GoHighLevel data"
Check that your PIT token is correct and has not expired. Verify your Location ID matches the sub-account you want to connect. Make sure you restarted Claude Code after updating the config.

"I am getting 401 errors"
Your token is either expired or incorrect. Create a new Private Integration and generate a fresh token.

"Claude can read data but cannot update anything"
Your permissions are set to "View" only. Go back to your Private Integration settings and enable "Edit" for the scopes you need.

"The MCP server is not appearing in Claude Code"
Double-check your config file syntax. A missing comma or bracket will break the JSON. Use a JSON validator if you are unsure.

FAQ

Do I need coding experience to set this up?

No. The setup is entirely configuration-based. You create a Private Integration in GoHighLevel, copy a token, and paste it into a config file. No code required.

Does this work with any GoHighLevel plan?

Yes. The MCP server and Private Integrations are available on all GoHighLevel plans: Starter ($97/month), Unlimited ($297/month), and SaaS Mode ($497/month).

Is my data safe with this connection?

The MCP connection runs through GoHighLevel's official API with token-based authentication. Your data stays in your GHL account. Claude Code accesses it on demand through the API. It does not store a copy of your database. Use minimum permissions and secure your token.

Can Claude Code make changes to my GoHighLevel account?

Yes, if you grant "Edit" permissions. Claude can update contact records, modify tags, and manage calendar data. Start with "View" permissions until you are comfortable, then enable "Edit" as needed.

How is this different from using Zapier or Make?

Zapier and Make are trigger-based automation tools. They react to events (new contact, form submission) and run predefined actions. Claude Code with MCP is conversational and on-demand. You ask it questions, request analysis, or tell it to perform actions in natural language. It is interactive, not just reactive.

Can I use this with Claude Desktop instead of Claude Code?

Yes. Claude Desktop supports MCP servers through the same configuration file. The setup process is identical.

What about the community MCP server with 269+ tools?

The community MCP server lists more separate tools than GoHighLevel's token server, though GoHighLevel's newer OAuth server now reaches invoices, payments and the social planner too. It is open-source and free. The trade-off is that it is community-maintained, so updates depend on contributors, not GoHighLevel's engineering team.

How does this compare to GoHighLevel's built-in AI features?

GHL's native AI features (like Conversation AI) are built into the platform for specific use cases. Claude Code with MCP is a general-purpose AI agent that can do anything the API allows. Think of GHL's AI as pre-built automations and Claude Code as a flexible assistant that adapts to whatever you ask it.

Getting Started Today

You do not need to implement every workflow at once. Start with the connection setup (10 minutes), then run your first pipeline review or lead audit. Once you see how much time it saves, the other workflows become obvious.

If you want your GoHighLevel account set up with proven funnels, pipeline stages, booking calendars, and automation workflows, get those right before you connect Claude Code. If you would rather hand the whole marketing job to someone else, here is how a fractional CMO, an agency and a marketing subscription compare. Or see how Havstock Unlimited works.

The AI layer works best when your foundation is solid. Get your GHL account dialed in first, then plug Claude Code on top to 10x your efficiency.

GoHighLevel

Free trial
30 days free14 days
Included
Missed call text backCRM and pipelinesTexts and email in one inboxCalendars and bookingFunnels and websitesWorkflows and automationsPhone numbers and callingFree live bootcamp
Start free trialSigning up direct gets 14 days.We may earn a commission.
Talk to Nate, Taylor and Channa

You run the business.
We’ll grow it.

Tell us what you need. We will call you to plan it.

GoHighLevel free for 30 daysPlus a free live bootcamp
Start trial