Disclosure: some links in this post are affiliate links. If you sign up through them I may earn a commission, at no extra cost to you.
Want to go deeper? I run a live Claude Code workshop — check the latest dates and see if you can still grab a seat.
Imagine typing a single sentence and watching your AI pull contacts from your GoHighLevel CRM, move deals through pipelines, schedule calendar appointments, and post content — all without touching a single workflow, Zapier zap, or API call. That’s exactly what’s possible when you connect Claude Code to GoHighLevel using MCP (Model Context Protocol).
This tutorial walks you through the complete GoHighLevel MCP setup from scratch — generating your private integration token, grabbing your location ID, dropping a config block into Claude Code, and running a live test to confirm everything is working.
What Is the GoHighLevel MCP Server?
MCP stands for Model Context Protocol — a standard that lets AI tools like Claude Code communicate directly with external platforms using structured endpoints, without needing middleware like Zapier or custom API wrappers.
GoHighLevel has published an official MCP server with 39 endpoints covering contacts, pipelines, tags, calendars, custom fields, and more. Official docs: marketplace.gohighlevel.com/docs/other/mcp
What Can Claude Code Do Inside GoHighLevel?
- Pull and search contacts
- Read and respond to conversations
- Move deals through pipelines
- Assign tags and custom fields
- Manage calendar availability
- Book appointments
- Post content and blog drafts
- Build AI voice bots and chatbots
Prerequisites
- Claude Code installed on your terminal
- VS Code + Node.js + Git Bash (Windows) or terminal (Mac)
- GoHighLevel sub-account access
Step 1: Create a Private Integration in GoHighLevel
Go to Settings → Private Integrations → Create New Integration. Name it Claude Code MCP. Enable only the permissions you need — do NOT enable all. Safe starting set: View Locations, Edit Calendars, View/Edit Contacts, View Pipelines, View Conversations, View/Edit Tags, View Custom Fields. Click Create and copy your PIT token immediately — you only see it once.
Step 2: Get Your Location ID
Go to Settings → Business Profile. Copy the Location ID and save it with your PIT token.
Step 3: Add the GHL MCP Config to Claude Code
Open a text file and paste the config block from the GHL docs. Replace YOUR_PIT_TOKEN_HERE with your PIT token and paste your Location ID in the designated field. In VS Code, open PowerShell terminal, paste the install command, hit Enter. You should see GHL MCP Added. Verify by typing mcp in Claude Code — look for GHL MCP Connected.
Step 4: Set Up Your GHL AI Agent File Structure
Create a folder called AI Agent Team in your dev directory with a GHL Agent subfolder. Download the agent template files and extract into that folder. The CLAUDE.md file is the directive for your agent — customize it with your pipeline names, calendar IDs, and tags. Set up the .env file with your PIT token and Location ID (rename from .env.example to .env).
Step 5: Run Your First GHL Discovery Test
In Claude Code, type: “Connect GHL. Pull all pipelines, tags, and custom fields. Save everything.” You should see success: true on each endpoint. HTTP 200 responses confirm full connection.
Example Queries
- “Who is in the Lead Management pipeline and how many contacts are in New Lead?”
- “Add [Name] as a new contact tagged as New Lead.”
- “What calendars do I have in GHL?”
- “Book [Name] on [Calendar] for tomorrow at 2pm.”
Required Tools and Prerequisites for Setup
Add Calendar IDs to CLAUDE.md
The GHL MCP has no list-calendars endpoint. Add your calendar IDs directly to CLAUDE.md so your agent can reference them instantly.
Multiple Sub-Accounts
Set up a separate GHL Agent folder per location with its own .env and MCP config. Keeps client accounts fully isolated.
Connect to Other Agents
The real power is chaining agents: content agent publishes → lead capture triggers → GHL agent tags contact, moves pipeline, books call. Fully automated end-to-end.
Scaling Into a Full AI Agent Team
- Content Agent: blogs, social, newsletters
- Lead Magnet Agent: opt-ins, sequences, scoring
- Outreach Agent: follow-up, reply detection, pipeline movement
- GHL Agent: CRM backbone — contacts, calendars, pipelines
FAQ
What is GoHighLevel MCP?
An official MCP server from GoHighLevel that lets AI tools like Claude Code connect directly to your sub-account and perform CRM actions without middleware.
How do I connect Claude Code to GoHighLevel?
Create a Private Integration in GHL Settings, get your PIT token and Location ID, then add one config block to Claude Code pointing to the GHL MCP server.
Do I need Zapier?
No. GHL MCP is a direct connection — no Zapier, no Make, no middleware required.
Is it safe?
Yes — with proper permissions. Only grant what your agent needs. Avoid granting all permissions as it includes destructive actions like deleting users.