⚡ Quick Answer (For People in a Hurry)
How do you connect Claude to GoHighLevel? You connect Claude to GoHighLevel using something called MCP (Model Context Protocol) — a technology that lets Claude talk directly to your GoHighLevel account. Once connected, you can type plain English sentences and Claude will manage your contacts, move deals in your pipeline, send messages, book appointments, and build AI workflows — all without you touching the GoHighLevel dashboard.
Setup takes 10-15 minutes. No coding required. The three things you need:
- A GoHighLevel account (any plan works — even the $97/month Starter)
- Claude Code or Claude Desktop installed on your computer
- A "Private Integration Token" from GoHighLevel (this guide shows you exactly how to get it)
📌 Table of Contents
- 1. What Is GoHighLevel & Why Connect AI?
- 2. What Is Claude & Differences From ChatGPT
- 3. What Is MCP? (Plain English Explanation)
- 4. What Claude Can Do Inside GoHighLevel
- 5. Checklist: What You Need Before Starting
- 6. Step-by-Step Setup Guide
- 7. How to Test Your Connection
- 8. Troubleshooting Common Errors
- 9. 25 Ready-to-Use CRM Prompts
- 10. How to Build Websites with Claude + GHL
- 11. How to Build Automations with Claude + GHL
- 12. How to Build AI Workflows with Claude + GHL
- 13. Claude MCP vs Zapier vs Make vs n8n
- 14. Official MCP Server vs Community Servers
- 15. Security: Keeping Your GHL Account Safe
- 16. FAQ — Every Question Answered
- 17. Summary & Next Steps
1. What Is GoHighLevel — And Why Would You Connect AI to It?
GoHighLevel (also called GHL or HighLevel) is an all-in-one marketing and CRM platform built specifically for agencies and service businesses. Think of it as your entire business back-end in one place.
Here's what GoHighLevel can do on its own:
- CRM (Customer Relationship Manager): Store and manage all your contacts, leads, and clients in one database.
- Pipeline Management: Track where each lead is in your sales process (e.g., New Lead → Contacted → Proposal Sent → Closed Won).
- Email & SMS Marketing: Send bulk campaigns or automated follow-up sequences.
- Funnel & Website Builder: Build landing pages, full websites, and sales funnels with a drag-and-drop editor.
- Calendar & Appointment Booking: Let leads book calls directly on your calendar.
- Automation Workflows: Build "if this, then that" rules — for example, "if someone fills out my form, send them an email, then text them 1 hour later".
- Reputation Management: Request and manage Google reviews.
- Reporting & Analytics: See how your campaigns and pipelines are performing.
⚠️ The Problem: GoHighLevel Still Requires a Lot of Manual Work
Even with all those features, running GoHighLevel day-to-day is still time-consuming. You're clicking through dashboards, manually updating contact records, reviewing pipeline stages one by one, writing the same follow-up email in slightly different words for each lead, and pulling reports into spreadsheets. That's where Claude comes in.
2. What Is Claude — And What Makes It Different From ChatGPT?
Claude is an AI assistant made by Anthropic, an AI safety company founded in 2021. Like ChatGPT (made by OpenAI), Claude can understand and generate text, answer questions, write content, analyze data, and help with complex tasks.
But for the purpose of connecting to GoHighLevel, there are two specific Claude products you need to know about:
🖥️ Claude Desktop
This is the downloadable app version of Claude that runs on your Mac or Windows computer. It lets you chat with Claude just like you would on the Claude.ai website — but because it's installed locally, it can connect to external tools through MCP.
Best for: Non-technical users💻 Claude Code
This is a more powerful, developer-oriented version of Claude that runs in your computer's terminal (the text-based command interface). Claude Code is specifically designed for agentic tasks — meaning it can take multi-step actions on your behalf, not just answer questions.
Best for: Power users & developers3. What Is MCP? (Plain English Explanation)
This is probably the most important concept to understand before you start the setup. Don't skip it — once you get what MCP is, everything else clicks.
The Problem MCP Solves: Imagine you want Claude to look at your GoHighLevel contacts and write personalized emails for each one. Before MCP existed, you'd have to export contacts as a CSV file, upload it manually to Claude, wait for it to write, and then copy each email back to GHL one by one.
What MCP Does: MCP (Model Context Protocol) is like giving Claude a direct phone line to your GoHighLevel account. Instead of exporting and importing data manually, Claude can call GoHighLevel directly, ask for real-time contact data, act on it immediately, and confirm it worked securely.
🔌 The USB Analogy
MCP is to AI agents what USB was to hardware. Before USB, every device needed its own special cable and adapter. USB created one universal standard that worked for everything. MCP does the same thing for AI — it's a universal standard that lets Claude "plug in" to any tool that supports it.
4. What Claude Can Do Inside GoHighLevel (Full Capability List)
Once Claude is connected to GoHighLevel via MCP, here is a comprehensive list of what it can actually do. This is based on GoHighLevel's official MCP server (which currently has 21 core tools) and community-extended MCP servers (which offer 460+ tools).
| Category | Tasks Claude Can Perform | Example Command |
|---|---|---|
| Contact Management | Read contacts, update info, apply/remove tags, merge duplicates, add notes | "Show me all contacts tagged 'Hot Lead' created this month" |
| Pipeline Management | Check pipeline status, move deals between stages, calculate pipeline value | "Move Alex Carter from 'Proposal Sent' to 'Negotiation'" |
| Calendar & Bookings | Check availability, book appointments, cancel or reschedule appointments | "Book the next available 30-minute slot for contact emily@example.com" |
| Messaging & Outreach | Draft and send personalized emails, text messages, view threads, analyze open rates | "Draft an SMS for all contacts who haven't replied in 5 days" |
| Reporting & Analytics | Revenue forecasting, lead source analysis, rep performance audits, campaign ROI summaries | "Give me a complete Monday briefing: pipeline health, new leads, and bookings" |
5. What You Need Before You Start (Checklist)
Before diving into the setup, make sure you have everything on this list. Taking 5 minutes here will save you 30 minutes of troubleshooting later.
- A GoHighLevel Account: Any plan works — Starter ($97/mo), Unlimited ($297/mo), or SaaS Mode.
- Admin Access: You need permissions to access Sub-account Settings → Private Integrations.
- A Computer (Mac or Windows): This setup doesn't work on mobile devices.
- Claude Desktop or Claude Code installed: Install the native Claude application or CLI tool.
- A Claude Pro Account: Recommended for heavy CRM usage.
6. Step-by-Step Setup: Connect Claude to GoHighLevel
PART A: Get Your Credentials from GoHighLevel
Step 1: Log Into Your GoHighLevel Sub-Account. Go to app.gohighlevel.com and make sure you are in the correct sub-account dashboard, not the Agency View.
Step 2: Navigate to Private Integrations. Click the Settings gear icon in the bottom-left sidebar, then click "Private Integrations" in the settings list.
Step 3: Create a New Integration. Click the blue "+ New Integration" button. Name it "Claude AI Integration" and save.
Step 4: Select Your Permissions. Check only what you need. View Contacts, Edit Contacts, View Pipelines, and Edit Opportunities are safe. Avoid checking billing or user management permissions.
Step 5: Copy Your Private Integration Token (PIT). GHL will show you a very long token string. Copy it immediately and save it in a password manager; GHL will only show it once.
Step 6: Copy Your Location ID. Go to Settings → Business Profile and copy your Location ID (a 20-character alphanumeric string).
PART B: Configure Claude
Path 1: Setting up Claude Desktop (No Terminal Needed)
Open your Claude Desktop configuration file (claude_desktop_config.json). You can find it by pressing Win + R and pasting %APPDATA%\Claude\ on Windows, or Cmd + Space and searching ~/Library/Application Support/Claude/ on macOS.
Paste the following configuration into the file:
{
"mcpServers": {
"gohighlevel": {
"command": "http",
"url": "https://services.leadconnectorhq.com/mcp/",
"headers": {
"Authorization": "Bearer YOUR_PRIVATE_INTEGRATION_TOKEN_HERE",
"x-location-id": "YOUR_LOCATION_ID_HERE"
}
}
}
} Replace the placeholder tokens with your actual GHL credentials, save the file, and completely restart the Claude Desktop application.
Path 2: Setting up Claude Code (For Command-Line Users)
Make sure you have Node.js installed, then run the CLI installer:
npm install -g @anthropic-ai/claude-code
In your project folder, create a hidden directory .claude/ and within it, create `config.json`.
{
"mcpServers": {
"gohighlevel": {
"command": "http",
"url": "https://services.leadconnectorhq.com/mcp/",
"headers": {
"Authorization": "Bearer YOUR_PRIVATE_INTEGRATION_TOKEN_HERE",
"x-location-id": "YOUR_LOCATION_ID_HERE"
}
}
}
}
Save the file, run claude in your terminal, and you are ready to command GHL!
7. How to Test If the Connection Is Working
Ask Claude these three test questions to verify the MCP connection has loaded properly:
- Test 1 (Basic Connection): "How many contacts do I have in GoHighLevel?" → Claude should scan the MCP and return a precise count.
- Test 2 (Pipeline Test): "List my active sales pipelines." → Claude should list all stages and values.
- Test 3 (Contact Search): "Show me the names of my 5 newest contacts." → Claude should render a clean table of records.
8. Troubleshooting: When Things Go Wrong
Here are the most common integration errors and how to resolve them immediately:
- Error: "401 Unauthorized"
Your Private Integration Token is incorrect, has spaces, or has expired. Make sure there is a single space between "Bearer" and your token. - Error: "403 Forbidden"
You are trying to perform an action Claude doesn't have permissions for. Go back to your GHL Settings → Private Integrations and check the missing permissions box. - Error: "Rate Limit Exceeded"
Claude sent too many discovery requests at once. Close and restart Claude completely to reset the API limits. - Claude says "I don't have access to GoHighLevel"
Your JSON configuration has a typo (missing quote or comma). Validate your JSON structure usingjsonlint.com.
9. 25 Ready-to-Use CRM Prompts
Copy and paste these commands straight into Claude to control your CRM. Adjust the names to match your GHL account:
📊 Pipeline Management
- "Give me a full breakdown of my Sales Pipeline by stage."
- "Which opportunities have been stuck for more than 14 days?"
- "Move John Doe to the Consultation Booked stage."
- "Calculate the total financial value of all open deals."
- "Draft a monthly pipeline status report."
👥 Contact Management
- "Find all contacts created this week tagged inbound."
- "Flag contacts that are missing phone numbers."
- "Add Mike Smith, mike@email.com, tag as Hot Lead."
- "Merge duplicate contacts for John Vance."
- "Add a note: Mike interested in our agency package."
✉️ Outreach & Follow-Up
- "Draft a personalized re-engagement SMS for stuck leads."
- "Write a follow-up email for everyone in Proposal stage."
- "Summarize my last chat thread with Sarah Connor."
- "Draft a reminder email for tomorrow's bookings."
- "Find leads that haven't responded to emails in 10 days."
📅 Calendar & Bookings
- "Show all slots currently open on my Sales Calendar."
- "Book a slot for contact emily@example.com on Thursday."
- "Reschedule my 3 PM meeting with David."
- "Find any appointment gaps in my calendar for next week."
- "List all bookings scheduled for tomorrow."
10. How to Build Websites Using Claude + GoHighLevel
One of the most powerful use cases is using Claude to dramatically speed up website and funnel creation inside GoHighLevel. While GoHighLevel has a visual builder, writing copy that converts is tough. Claude can write exact copy for every single block of your landing page based on your target audience.
🛠️ The Website Building Workflow:
- Step 1: Chat with Claude to define your business offer, target market, and pricing.
- Step 2: Ask Claude to generate the page structure section-by-section (e.g., Hero, Features, Social Proof, Pricing).
- Step 3: Refine specific paragraphs and write compelling calls-to-action (CTAs).
- Step 4: Ask Claude to draft support assets (intake forms, confirmation pop-ups, custom thank-you screens).
- Step 5: Go to GoHighLevel, open the drag-and-drop website editor, select a grid template, and paste Claude's copy block-by-block.
11. How to Build Automations Using Claude + GoHighLevel
Automations inside GoHighLevel are the rules that govern the flow of leads (e.g., if a form is filled, send an SMS). Claude can help design these triggers and actions.
Way 1: Claude Designs the Workflow. Ask Claude to map out a complete automation in plain English. For example, tell it: "Design a 5-day welcome sequence for real estate leads who downloaded my PDF guide." Claude will outline the triggers, wait states, and actions, which you then replicate inside the GHL workflow editor.
Way 2: On-Demand Actions. Use Claude to run complex data cleanups and audits that standard GHL automation rules can't handle. For example, you can tell Claude to scan your CRM, find all leads that haven't replied in 30 days, tag them as 'Cold Lead', and email them a reactivation offer.
12. How to Build AI Workflows Using Claude + GoHighLevel
An AI Workflow goes beyond basic automation because it is adaptive. It uses Claude's reasoning capabilities to evaluate customer interactions in real-time.
🚀 Workflow 1: The Weekly Revenue Command Center
You run this each Monday morning. You ask Claude: "Analyze my sales pipeline and identify any high-value deals that are stalling. Provide an actionable follow-up plan for each." Claude will examine your opportunities, highlight at-risk deals, and write personalized email drafts for each.
📬 Workflow 2: The Intelligent Lead Intake System
When a new lead fills out a form, instead of a simple email auto-reply, Claude reads the form fields, categorizes the business type, scores the lead quality, and applies relevant tags inside GHL.
📞 Workflow 3: The Post-Call Intelligence System
After you finish a sales call, you paste the transcript to Claude. Claude updates the contact record with call notes, automatically moves the contact to 'Proposal Sent' stage, and generates a personalized proposal email in seconds.
13. Claude MCP vs Zapier vs Make vs n8n — Full Comparison
Why use Claude MCP instead of classic integration platforms? Here's the difference:
| Feature | Claude + MCP | Zapier / Make | n8n |
|---|---|---|---|
| How it's triggered | You ask in plain English (on-demand) | Event-driven triggers (automated) | Event or schedule (automation) |
| Understands natural language | Yes — native capability | No — strictly logic-based | Limited (unless AI nodes used) |
| Multi-step reasoning | Yes — analyzes and decides | No — executes predefined rules | No — executes static pipelines |
| Middleware required | None — direct secure connection | Yes — requires separate account | Yes — requires hosting/setup |
14. Official MCP Server vs Community MCP Servers
When connecting Claude to your GHL account, you have two server options:
- Official GoHighLevel MCP Server: Maintained directly by HighLevel. Offers 21 core tools covering contacts, pipelines, calendars, conversations, and tags. Extremely secure and reliable. Recommended for 90% of business users.
- Community-Created MCP Servers: Maintained by independent open-source developers. Exposes up to 520+ tools across the entire GHL API, covering invoicing, e-commerce, proposals, media libraries, and the social planner. Requires self-hosting and carries potential security risks.
15. Security: How to Keep Your GHL Account Safe
Giving an AI agent access to your CRM containing client lists, opportunities, and business revenue must be managed carefully. Keep these security rules in place:
- Use minimum permissions: Start with "View Only" permissions. Once you are confident Claude understands your account correctly, add "Edit" permissions. Never give Claude admin permissions (like delete contacts or manage team members).
- Treat your PIT like a password: Your Private Integration Token is a skeleton key for your CRM. Store it in encrypted password managers like Bitwarden or Keychain. Never post it in Slack, share it in Loom videos, or leave it in plain text files.
- Rotate your token every 90 days: Go to GHL settings and select "Rotate and expire later" to smoothly transition to a new key without breaking your live connection.
- Always add an "Ask First" rule: In your Claude instructions, include: "Confirm with me in plain English before making any bulk edits or pipeline moves."
16. FAQ — Every Question Answered
Q: Do I need to know how to code to connect Claude to GoHighLevel?
No. The setup requires editing a configuration file (which is just a text file with specific formatting), but this guide walks you through every character. Thousands of non-technical agency owners and consultants are using this integration successfully.
Q: How much does this cost?
The MCP connection itself is entirely free and included with your GoHighLevel account. You only pay for your GHL subscription (from $97/mo) and your Claude account (Claude Pro is $20/mo, or pay-as-you-go usage credits for Claude Code).
Q: Can I connect Claude to multiple sub-accounts?
Yes. For Claude Code, create a separate project directory for each client sub-account, each with its own configuration and unique PIT. For Claude Desktop, you'll need to manually swap out the location headers in the config file.
Q: Is my client data safe? Does Anthropic see my CRM data?
Claude accesses your data on-demand through the official API. It does not maintain a permanent local copy of your CRM. For strict data protection, review Anthropic's business and enterprise privacy policies.
17. Summary & Next Steps
Connecting Claude with GoHighLevel via the Model Context Protocol (MCP) completely shifts how you manage your CRM. Instead of clicking through complex layouts, you describe what you want in plain English, and the AI agent executes the request securely.
📅 Your Action Plan:
👉 Day 1 Tasks
- Get PIT and Location ID from GHL
- Install Claude Desktop
- Add GHL server to config
- Run the 3 connection tests
👉 Day 2-3 Tasks
- Try 10 different CRM prompts
- Create custom directive files
- Audit manual CRM overhead
👉 Week 1+ Tasks
- Add 'Edit Contacts' permissions
- Run your first email follow-up sequence
- Configure post-call summary workflows
📋 Quick Reference Card
GHL MCP Server URL: https://services.leadconnectorhq.com/mcp/
Claude Desktop Config Path (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop Config Path (Windows): %APPDATA%\Claude\claude_desktop_config.json
Required Token Format: "Bearer eyJhbGciOi..."
Want a Custom AI CRM Integration?
Need help connecting Claude or other advanced LLMs into your GoHighLevel account? We build scalable, secure AI automations and custom workspaces for high-growth digital agencies.
Connect With an AI Architect