GoHighLevel MCP
This server enables comprehensive AI-driven management of a GoHighLevel sub-account, covering CRM, marketing, sales, and operations. Core capabilities:
Contacts: CRUD, tags, notes, tasks, workflow enrollment, appointments
Conversations: Search, send (SMS, email, WhatsApp, social), schedule, cancel, inject inbound messages, manage status
Calendars: List, availability, book/reschedule/cancel, block slots
Opportunities: Pipelines, stages, CRUD, move deals, won/lost/abandoned
Marketing: Email templates/campaigns, social planner (queue, comments, OAuth, stats), ads (Facebook, Google, LinkedIn), funnels, blogs
E-commerce: Products, prices, inventory, collections, shipping, payments, invoices, coupons, subscriptions, affiliates
AI & Automation: Workflows, campaigns, conversation AI, voice AI, agent studio, chat widgets
Customization: Custom fields/objects, menus, brand boards/voices, knowledge bases, forms, surveys
Administration: Users, businesses, associations, location settings, phone numbers, email verification
Enables sending WhatsApp messages to contacts in GoHighLevel.
GoHighLevel MCP Server
Give any AI agent — Claude, Cursor, Windsurf, or any MCP-compatible client — full access to your GoHighLevel account through natural language.
What is this?
This is a Model Context Protocol (MCP) server that connects your AI tools directly to your GoHighLevel (GHL) sub-account via the GHL API v3.
Once installed, you can talk to your CRM naturally:
"Find all contacts tagged 'cold-lead' and send them an SMS saying we have a new offer" "Book an appointment for Sarah Johnson tomorrow at 2pm on the Discovery calendar" "Move any open opportunities in Stage 1 that haven't been touched in 14 days to 'Lost'" "Create a note on John's contact record and enroll him in the cold call workflow"
401 tools covering the full GHL API:
Category | Tools |
Contacts | CRUD, search, upsert, tags, notes, tasks, workflow enrollment, appointments |
Conversations & Messaging | Search, send SMS/email/WhatsApp, schedule, message history |
Calendars & Appointments | List calendars, check availability, book, reschedule, block slots |
Opportunities / Pipeline | Pipelines, deals, stage moves, won/lost/abandoned |
Workflows & Campaigns | List workflows and campaigns |
Location Settings | Custom fields, custom values, tags, users, templates, forms, surveys |
Email Marketing | Email builder templates, email campaigns, scheduling |
Funnels | List funnels, pages, page counts |
Phone Numbers | List, search, purchase, update, release phone numbers |
Payments & Invoices | Orders, transactions, subscriptions, coupons, invoices, payments |
Social & Media | Social posts, media library, trigger links |
Social Planner | Content queues & scheduling, comment moderation, OAuth account connection, CSV bulk-import posting, post/statistics (see note below) |
Knowledge Base, FAQs & Crawler | Create/manage knowledge bases, FAQ pairs, and AI-train websites via crawler |
Products, Collections & Reviews | Products, prices, inventory, collections, reviews, store visibility & priority |
Store & Shipping | Shipping carriers, zones, rates, and store settings |
Affiliates | List affiliates, commissions, and payouts |
Email Verification | Single-use email address verification (deliverability check) |
Blogs | Authors, categories, sites, posts, slug checks, create/update posts |
Courses & Proposals | Import courses; proposal/estimate documents and templates |
Brand Boards & Voices | Brand boards (logos/colors/fonts) and brand voices, incl. defaults |
Custom Menus | Custom menu links: list, get, create, update, delete |
Conversation AI | CRUD conversation AI agents, attach/manage agent actions, follow-up settings, generation |
Voice AI | CRUD voice AI agents & actions, call logs |
Chat Widget | CRUD chat widgets, clone, config, list |
Agent Studio | CRUD Agent Studio agents, versioning, publish, execute |
Businesses | CRUD businesses within a location |
Associations | CRUD associations and association relations between records |
Objects | Get/update custom object schemas, list objects, CRUD & search object records |
Facebook Ads | Ad accounts, page/Instagram/integration setup, campaigns, ad sets, ads, custom audiences, pixels, lead & conversation forms, reporting, targeting search (48 tools) |
Google Ads | Ad accounts, integration, campaigns, creative assets, keyword ideas, audiences, segments, conversion actions, reporting, targeting search (31 tools) |
LinkedIn Ads | Ad accounts, integration, campaign groups, lead forms, reporting, targeting search (16 tools) |
Not yet covered: the following GHL API v3 resources require credentials this server doesn't have (agency-level or Marketplace-app-developer identity, not a location-scoped Private Integration Token) and are intentionally left unbuilt:
saas— agency-level SaaS mode, rebilling, wallet balances. Seedocs/superpowers/specs/2026-08-04-v3-phase2a-commerce-design.md.
marketplace— app installs/uninstalls, billing-wallet charges, rebilling config. Seedocs/superpowers/specs/2026-08-04-v3-phase2b-marketing-design.md.
companies— agency/company-level account details. Requires agency-level credentials; this server authenticates via a location-scoped PIT token and has no agency-level identity.
snapshots— agency-level snapshot push/share/status operations. Same agency-only credential requirement.
oauth— Marketplace app installation/token endpoints. Requires a Marketplace-app-developer identity, not a location-scoped PIT token.If you need any of these and have the right credential type, please open an issue requesting it.
Also not covered (no credential issue — the endpoint doesn't exist):
ghl_create_template/ghl_update_templatewere removed. The v3 (and legacy)/locations/{locationId}/templatesresource only exposesGET(list) andDELETE; noPOST/PUToperation exists anywhere in the spec for creating or updating a template. This was verified via an exhaustive sweep of every v3 and legacy spec file.ghl_get_templates/ghl_delete_templateremain fully supported.
Related MCP server: ghl-mcp
Prerequisites
Before you begin, make sure you have:
Node.js 18 or later — download here
A GoHighLevel account with sub-account access
A GHL Private Integration Token (takes ~2 minutes to create — see below)
How to get your GHL credentials
1. Private Integration Token (GHL_PIT_TOKEN)
Log in to GoHighLevel and navigate to your sub-account (not the agency dashboard)
Go to Settings → Private Integrations
Click + Create New Integration
Give it a name (e.g.
AI Agent) and select all the scopes you want to grantClick Create — copy the token that appears (you won't see it again)
⚠️ Keep this token secret. It grants full API access to your sub-account.
2. Location ID (GHL_LOCATION)
Your Location ID is in the URL when you're inside your sub-account:
https://app.gohighlevel.com/location/XXXXXXXXXXXXXXXXXX/dashboard
^^^^^^^^^^^^^^^^^^
This is your Location IDInstallation
No build step needed. Pass your credentials directly in your AI client config and the server runs on demand.
Quick install via package manager (recommended)
Use npx, pnpm dlx, or bunx to run the server without installing anything globally:
# npm / npx (no install required)
npx @nerdsnipe-inc/ghl-mcp-server
# pnpm
pnpm dlx @nerdsnipe-inc/ghl-mcp-server
# bun
bunx @nerdsnipe-inc/ghl-mcp-serverOr install it globally if you prefer:
npm install -g @nerdsnipe-inc/ghl-mcp-server
# then run:
ghl-mcp-serverConnect to your AI tool
Pick your AI client below and follow the instructions.
Connecting to AI Clients
Claude Desktop
Open (or create) your Claude Desktop config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"ghl": {
"command": "npx",
"args": ["-y", "@nerdsnipe-inc/ghl-mcp-server"],
"env": {
"GHL_PIT_TOKEN": "your_token_here",
"GHL_LOCATION": "your_location_id_here"
}
}
}
}Restart Claude Desktop. You should see a hammer icon (🔨) in the chat input — that means MCP tools are active.
Claude Code (CLI)
Run this from your terminal to add the server to your Claude Code config:
claude mcp add ghl npx -- -y @nerdsnipe-inc/ghl-mcp-server \
-e GHL_PIT_TOKEN=your_token_here \
-e GHL_LOCATION=your_location_id_hereOr add it manually to ~/.claude/mcp_servers.json (or your project's .mcp.json):
{
"mcpServers": {
"ghl": {
"command": "npx",
"args": ["-y", "@nerdsnipe-inc/ghl-mcp-server"],
"env": {
"GHL_PIT_TOKEN": "your_token_here",
"GHL_LOCATION": "your_location_id_here"
}
}
}
}Project-scoped tip: Add a
.mcp.jsonin your project root so everyone on the team picks it up automatically — no local install required. Add.mcp.jsonto.gitignoreso tokens aren't committed. If you store credentials in a.envfile you can omit theenvblock entirely.
Cursor
Open Cursor Settings → MCP (or press
Cmd+Shift+P→ "Open MCP Settings")Click Add Server and fill in:
{
"name": "ghl",
"command": "npx",
"args": ["-y", "@nerdsnipe-inc/ghl-mcp-server"],
"env": {
"GHL_PIT_TOKEN": "your_token_here",
"GHL_LOCATION": "your_location_id_here"
}
}Save and restart Cursor.
Windsurf
Open ~/.codeium/windsurf/mcp_config.json and add:
{
"mcpServers": {
"ghl": {
"command": "npx",
"args": ["-y", "@nerdsnipe-inc/ghl-mcp-server"],
"env": {
"GHL_PIT_TOKEN": "your_token_here",
"GHL_LOCATION": "your_location_id_here"
}
}
}
}Any other MCP-compatible client
This server uses stdio transport — the standard for local MCP servers. Your client needs:
Command:
npxArgs:
["-y", "@nerdsnipe-inc/ghl-mcp-server"]Env:
GHL_PIT_TOKENandGHL_LOCATION
Refer to your client's MCP documentation for exact config syntax.
Running from source (contributors)
If you've cloned the repo and want to run directly from TypeScript without a build step:
git clone https://github.com/Nerdsnipe-Inc/ghl-mcp-server.git
cd ghl-mcp-server
npm installThen point your MCP client at the source via tsx:
{
"command": "npx",
"args": ["tsx", "/absolute/path/to/ghl-mcp-server/src/index.ts"]
}Or build first for production use:
npm run build
# then run:
node dist/index.jsAll 401 Tools — Full Reference
Contacts
Tool | Description |
| Get a single contact by ID |
| Create a new contact |
| Update contact fields |
| Create or update by email/phone (prevents duplicates) |
| Permanently delete a contact |
| Advanced search with filter conditions |
| Add tags to a contact |
| Remove tags from a contact |
| List all notes on a contact |
| Add a note to a contact |
| Update an existing note |
| Delete a note |
| List tasks for a contact |
| Create a task for a contact |
| Update a task (status, due date, etc.) |
| Delete a task |
| Enroll a contact in a workflow/automation |
| Remove a contact from a workflow |
| Get all appointments for a contact |
Conversations & Messaging
Tool | Description |
| Search conversations by contact, status, or channel |
| Get a conversation by ID |
| Open a new conversation thread |
| List messages in a conversation |
| Send SMS, email, WhatsApp, or other channel message |
| Send an email within an existing conversation |
| Mark messages read/unread/delivered |
| Cancel a scheduled (future) message |
| Inject an inbound message (testing/simulation) |
Calendars & Appointments
Tool | Description |
| List all calendars |
| Get a calendar by ID |
| Check available appointment slots in a date range |
| Get events/appointments in a date range |
| Book an appointment |
| Get an appointment by event ID |
| Reschedule, change status, or add notes |
| Delete an event or appointment |
| Block a time period on a calendar |
| List calendar groups |
Opportunities / Pipeline
Tool | Description |
| List all pipelines and their stages |
| Search deals by contact, stage, pipeline, or status |
| Get a single opportunity |
| Create a new deal |
| Update deal fields (stage, value, assignee) |
| Quickly mark a deal won/lost/abandoned |
| Create or update a deal |
| Delete a deal |
Workflows & Campaigns
Tool | Description |
| List all workflows (use to discover workflow IDs) |
| List all campaigns |
Enrolling contacts in workflows is done via
ghl_add_contact_to_workflow.
Email Marketing
Tool | Description |
| List all email builder templates in the location |
| Get a single email builder template by ID |
| Create a new email builder template with HTML content |
| Update an existing email builder template's HTML content |
| Delete an email builder template by ID |
| List all email campaigns in the location |
| Get details of a single email campaign by ID |
| Create a new email campaign as a draft (v3 does not accept |
| Schedule (or immediately send) a draft campaign — sets subject, sender, recipients, and send timing ( |
| Delete an email campaign by ID |
Funnels
Tool | Description |
| List all funnels in the location |
| List all pages in a specific funnel |
| Get the total count of pages in a funnel |
Phone Numbers
Tool | Description |
| List all purchased/active phone numbers in the location |
| Search for available numbers to purchase (filter by area code, country, type) |
| Purchase a phone number for the location (E.164 format, e.g. |
| Update settings for a phone number (assignment, call forwarding) |
| Release (delete) a phone number from the location |
Surveys
Tool | Description |
| List all surveys created in the location |
| Get submissions for a survey, with optional filters |
Location Settings
Tool | Description |
| Get location/sub-account details |
| List all tags in the location |
| Create a new tag |
| Delete a tag |
| List custom contact fields |
| Create a custom field |
| Update a custom field |
| Delete a custom field |
| List custom values (location-level variables) |
| Create a custom value |
| Update a custom value |
| Delete a custom value by ID |
| List all team members |
| Search users by name or email |
| Get a single team member by user ID |
| Create a new team member in the location |
| Update an existing team member |
| Remove a team member from the location |
| List SMS/email/WhatsApp templates |
| Delete a template by ID |
| List all forms |
| Get form submissions |
Payments & Invoices
Tool | Description |
| List payment orders |
| Get a single order |
| List payment transactions |
| List active subscriptions |
| List coupons |
| Create a discount coupon |
| List invoices |
| Get a single invoice |
| Create a new invoice |
| Email an invoice to the contact |
| Void (cancel) an invoice |
| Record a manual payment on an invoice |
Social & Media
These 4
ghl_*_social_*/media/trigger-link tools were built in Phase 1 against a small slice of the/social-media-posting/resource. The Social Planner sections below (Phase 2e) cover the other 41 operations on that same resource — content queues, comment moderation, OAuth account connection, CSV bulk-import, and the remaining post/statistics endpoints. The two use different naming conventions (social.tsvs.social_planner_*.ts) because they were designed in separate phases; together they cover all 45social-planner-v3.jsonoperations.
Tool | Description |
| List connected social media accounts |
| List scheduled or published posts |
| Schedule or publish a social media post |
| Delete a scheduled post |
| List files in the media library |
| Delete a file from the media library |
| List trigger links |
| Create a trigger link |
| Delete a trigger link |
Social Planner Queues
Content queue creation/configuration, queue items, edit sessions, calendar views, and slots (Phase 2e — see note above).
Tool | Description |
| Create a content queue for a social media category |
| List social media categories available for creating queues |
| List content queues for the location |
| Fetch a calendar view of queued posts |
| Delete the currently active queue post and schedule the next one |
| Get a content queue by ID |
| Update a content queue |
| Create a new item in a content queue |
| Fetch a calendar view of an active edit session |
| Discard an active queue edit session |
| Save an active queue edit session |
| Start a new edit session for a content queue |
| List items in a content queue |
| Delete an item from a content queue |
| Update an item in a content queue |
| Clone an item in a content queue |
| Reset an item in a content queue back to its original state |
| List available posting slots for a content queue |
Social Planner Comments
Comment moderation on social media posts (Phase 2e — see note above).
Tool | Description |
| Create a new comment on a social media post |
| List comments for one or more social media posts |
| Like a social media comment |
| Unlike a social media comment |
Social Planner Accounts
OAuth account connection flow, plus account/category/tag management (Phase 2e — see note above).
Tool | Description |
| Step 1 of 3: start OAuth for a social platform |
| Step 2 of 3: list the pages/channels/locations available to connect |
| Step 3 of 3: connect the account/page selected in step 2 to this location |
| Delete a connected social media account (and remove it from its group) |
| Associate connected social accounts with an already-uploaded CSV bulk-import job |
| List social media categories for this location |
| Get a single social media category by ID |
| List social media tags for this location |
| Get multiple social media tags by their IDs |
Social Planner Posts
CSV bulk-import posting, remaining post operations, and statistics (Phase 2e — see note above).
Tool | Description |
| Step 1 of the CSV bulk-import flow: upload a CSV file of social media posts |
| List CSV bulk-import jobs (uploads) for this location |
| Get the parsed rows/posts of a single CSV bulk-import job by ID |
| Finalize (commit) a CSV bulk-import job, scheduling/publishing its parsed posts |
| Delete a CSV bulk-import job entirely (all its parsed posts) |
| Delete a single post row from a CSV bulk-import job |
| Delete multiple social media posts by ID in a single request |
| Get a single social media post by ID |
| Update an existing social media post (content, schedule, status, media, etc.) |
| Get engagement/analytics statistics for connected social accounts |
Knowledge Bases
Tool | Description |
| List all knowledge bases for the location with cursor-based pagination |
| Get a single knowledge base by ID — includes metadata counts (FAQs, URLs, files) |
| Create a new knowledge base (max 15 per location) |
| Update the name or description of an existing knowledge base |
| Permanently delete a knowledge base and all its content (FAQs, trained URLs, etc.) |
FAQs
Tool | Description |
| List all FAQ question/answer pairs for a knowledge base with cursor-based pagination |
| Add a new FAQ question and answer to a knowledge base |
| Update the question and answer text of an existing FAQ |
| Permanently delete an FAQ by ID |
Web Crawler
Use the crawler to discover and ingest website pages as AI training data for a knowledge base. The typical flow is: discover → check status → train.
Tool | Description |
| Start crawling a website to discover pages. Choose scope: |
| Check progress of a crawl job by |
| List all trained page links for a knowledge base. Use to retrieve |
| Ingest discovered pages into the knowledge base for AI training using |
| Remove previously trained page URLs from a knowledge base by |
Products, Collections & Reviews
Tool | Description |
| List/search products in the location |
| Get a single product by ID |
| Create a new product |
| Update an existing product |
| Delete a product |
| Bulk-update multiple products (price, availability, etc.) — also supports bulk-delete |
| Bulk-edit prices across multiple products |
| List prices for a product |
| Get a single price by ID |
| Add a new price to a product |
| Update an existing price |
| Delete a price |
| Get inventory levels for products |
| Update inventory counts for products |
| List product collections |
| Get a single collection by ID |
| Create a new product collection |
| Update a product collection |
| Delete a product collection |
| List reviews for a product |
| Get the total review count (with optional filters) |
| Bulk-update review status (e.g. publish/hide) across reviews |
| Update a single review |
| Delete a review |
| Show/hide a product in the storefront |
| Change a product's sort priority in the storefront |
| Get storefront stats for products |
Store & Shipping
Tool | Description |
| List shipping carriers configured for the store |
| Add a new shipping carrier |
| Get a single shipping carrier by ID |
| Update a shipping carrier |
| Delete a shipping carrier |
| List shipping zones |
| Create a new shipping zone |
| Get a single shipping zone by ID |
| Update a shipping zone |
| Delete a shipping zone |
| Get rates available for a given shipment |
| List configured shipping rates |
| Create a new shipping rate |
| Get a single shipping rate by ID |
| Update a shipping rate |
| Delete a shipping rate |
| Get store-wide settings |
| Update store-wide settings |
Affiliates
Tool | Description |
| List affiliates in the location |
| Get a single affiliate by ID |
| List commissions earned by affiliates |
| List payouts made to affiliates |
Email Verification
Tool | Description |
| Verify an email address's deliverability (single-use ISV check) |
Blogs
Tool | Description |
| List blog authors for the location |
| List blog categories for the location |
| List blog sites for the location |
| List posts for a blog, with search and status filtering |
| Check whether a URL slug is already in use by another blog post |
| Create a new blog post |
| Update an existing blog post |
Courses & Proposals
Tool | Description |
| Import courses with lessons and modules from product objects |
| List proposal/estimate documents, with status/date/search filtering |
| Send a proposal/estimate document to a client |
| List proposal/estimate document templates |
| Send a proposal/estimate document template to a client contact |
Brand Boards & Voices
Tool | Description |
| Create a brand board (logos, colors, fonts) — blank, from template, snapshot, or extracted from a URL |
| List brand boards for the location |
| Get a single brand board by ID |
| Update a brand board by ID |
| Delete a brand board by ID |
| List brand voices for the location |
| Create a brand voice |
| Get a brand voice by ID |
| Update a brand voice by ID |
| Delete a brand voice by ID |
| Set a brand voice as the default for the location |
Custom Menus
Tool | Description |
| List custom menu links, with search, pagination, and agency filter |
| Get a single custom menu link by ID |
| Create a custom menu link |
| Update a custom menu link by ID |
| Delete a custom menu link by ID |
Conversation AI
Tool | Description |
| Create a new Conversation AI agent (name, personality, goal, instructions) |
| Search Conversation AI agents by name, with pagination |
| Get a Conversation AI agent by ID |
| Update a Conversation AI agent's configuration |
| Delete a Conversation AI agent by ID |
| Attach a new action (workflow trigger, field update, booking, etc.) to an agent |
| List all actions attached to a Conversation AI agent |
| Get a single action attached to a Conversation AI agent |
| Update an existing action attached to a Conversation AI agent |
| Remove an action from a Conversation AI agent |
| Update the follow-up settings (channel switching, working hours) for an agent |
| Get an AI-generated message for a conversation or workflow message |
Voice AI
Tool | Description |
| Create a new Voice AI action attached to an agent |
| Update a Voice AI action |
| Get a single Voice AI action by ID |
| Delete a Voice AI action |
| Create a new Voice AI agent (greeting, prompt, voice, working hours, etc.) |
| List Voice AI agents for the location, with search and pagination |
| Update a Voice AI agent's configuration |
| Get a Voice AI agent by ID |
| Delete a Voice AI agent by ID |
| Get the Voice AI call-log dashboard, with filters and pagination |
| Get a single Voice AI call log entry by call ID |
Chat Widget
Tool | Description |
| Create a new chat widget for the sub-account |
| Create a copy of an existing chat widget in the same sub-account |
| Get a single chat widget by ID |
| Full update (PUT) of a chat widget resource |
| Partial update (PATCH) of a chat widget resource |
| List chat widgets for the sub-account, with pagination and filters |
| Get a widget's display/behavior configuration by ID |
| Soft-delete a chat widget |
Agent Studio
Tool | Description |
| Create a new Agent Studio agent with an initial staging version |
| List Agent Studio agents for the sub-account, with pagination |
| Get a single Agent Studio agent by ID, including its non-deleted versions |
| Update an agent's top-level metadata (name, description, status) |
| Delete an Agent Studio agent and all of its versions |
| Update a version's workflow definition (nodes, edges, variables) |
| Promote a draft version to production, publishing it |
| Execute an Agent Studio agent and get a non-streaming JSON response |
Businesses
Tool | Description |
| List businesses for a location |
| Get a specific business by ID |
| Create a new business |
| Update an existing business |
| Delete a business |
Associations
Tool | Description |
| Create a relation between two records for an association |
| List relations for a record |
| Delete a relation between two records |
| Get an association by its key name |
| Get an association by its object key |
| Create a new association |
| Get a specific association by ID |
| Update an association's object labels |
| Delete an association |
| List associations for a location |
Objects
Tool | Description |
| Get a custom or standard object schema by key |
| Update a custom object schema |
| List all objects (standard and custom) for the location |
| Get a single custom object record by ID |
| Update a custom object record |
| Delete a custom object record |
| Create a new custom object record |
| Search custom object records |
Facebook Accounts
Note: all
ad-publishingoperations hit paths under/ad-publishing/<platform>/.... Despite thead-publishing-v3.jsonspec filename, 94 of these 95 operations declare a legacyVersion: 2021-07-28header rather than a v3 header — the sole exception isghl_get_facebook_campaign_publishing_progress, which usesv3. Seesrc/client.ts'sGHL_VERSION_LEGACY/GHL_VERSION_V3and the in-file code comments in eachsrc/tools/facebook_*.ts/google_*.ts/linkedin.tsmodule for details.
Tool | Description |
| List Facebook ad accounts connected to a location |
| Get a single Facebook ad account by ID |
| Delete a Facebook ad account |
| Create a Facebook ad-publishing integration for a location |
| Get the Facebook ad-publishing integration for a location |
| Delete the Facebook ad-publishing integration for a location |
| Get the Facebook identity (user/page) tied to the location's integration |
| List Facebook ad entities (campaigns, ad sets, or ads) |
| List Facebook pages available to a location |
| Disconnect a Facebook page from a location |
| Set the default Facebook page for a location |
| List lead forms for a Facebook page |
| Create a Facebook lead form on a page |
| List Instagram accounts linked to a Facebook page |
Facebook Campaigns
Tool | Description |
| Get a single Facebook campaign by ID |
| Create or update a Facebook campaign — pass |
| Delete a Facebook campaign |
| Duplicate a Facebook campaign |
| Pause a Facebook campaign |
| Publish a Facebook campaign |
| Get the publishing progress of a Facebook campaign |
| Resume a paused Facebook campaign |
| Create or update a Facebook ad set — pass |
| Delete a Facebook ad set |
| Duplicate a Facebook ad set |
| Pause a Facebook ad set |
| Resume a paused Facebook ad set |
| Create or update a Facebook ad — pass |
| Delete a Facebook ad |
| Duplicate a Facebook ad |
| Pause a Facebook ad |
| Resume a paused Facebook ad |
Facebook Audiences
Tool | Description |
| Get Facebook custom audiences for a location |
| Delete a Facebook custom audience |
| Update a Facebook custom audience's name and description |
| Get a single Facebook custom audience by ID |
| Add a contact to a Facebook custom audience |
| Remove a contact from a Facebook custom audience |
| Batch add/remove members of a Facebook custom audience via CSV, smartlists, or dynamic audience |
| Get Facebook conversion pixels for a location |
| Create or update a Facebook conversion pixel |
| Get Facebook conversation forms for a location |
| Create a Facebook conversation form |
| Get a single Facebook lead form by ID |
Facebook Reporting
Tool | Description |
| Get Facebook ad reporting data with aggregation |
| Get reporting data for a specific Facebook campaign |
| Get a list of Facebook reporting data (campaigns, ad sets, or ads) |
| Search Facebook targeting options (interests, behaviors, demographics) |
Google Accounts
Tool | Description |
| List Google ad accounts connected to a location |
| Get a single Google ad account by ID |
| Delete a Google ad account |
| Create a Google ad-publishing integration for a location |
| Get the Google ad-publishing integration for a location |
| Get the Google identity tied to the location's integration |
| List Google ad entities (campaigns, ad groups, or ads) |
Google Campaigns
Tool | Description |
| Create or update a Google Ads campaign — pass |
| Get a single Google Ads campaign by ID |
| Publish a Google Ads campaign and push it live |
| List Google Ads creative assets |
| Create or update a Google Ads creative asset (call, sitelink, or lead form) |
| Get Google Ads keyword ideas for a target URL |
Google Audiences
Tool | Description |
| Create or update a Google Ads audience — pass |
| List Google Ads audiences for the location |
| Get a single Google Ads audience by ID |
| List Google Ads segments for the location |
| Create or update a Google Ads segment — pass |
| Create a Google Ads offline user list upload job |
| Delete a Google Ads segment |
| Get a single Google Ads segment by ID |
| List Google Ads conversion actions for the location |
| Create or update a Google Ads conversion action — pass |
| Get a single Google Ads conversion action by ID |
| Delete a Google Ads conversion action |
| List Google Ads conversion goals for the location |
| Search Google Ads target interest categories |
Google Reporting
Tool | Description |
| Get Google Ads reporting data with aggregation |
| Get reporting data for a specific Google Ads campaign |
| Get a list of Google Ads reporting data (e.g. campaigns) |
| Search Google Ads targeting options (e.g. geolocation) |
Tool | Description |
| Get a connected LinkedIn ad account |
| Delete a connected LinkedIn ad account |
| List connected LinkedIn ad accounts for the location |
| Create a LinkedIn ad account integration for the location |
| Get the LinkedIn ad account integration for the location |
| Get the authenticated LinkedIn member profile for the location's integration |
| Create or update a LinkedIn ad campaign group — pass |
| Get a single LinkedIn ad campaign group by ID |
| Publish a LinkedIn ad campaign group to LinkedIn |
| Update the status (paused, archived, resume) of a LinkedIn ad entity |
| Create a LinkedIn lead-gen form for an ad account |
| List LinkedIn lead-gen forms for an ad account |
| Get LinkedIn ad reporting analytics |
| Get LinkedIn ad reporting analytics for a specific campaign group |
| Get a LinkedIn reporting list for a campaign within a campaign group |
| Search LinkedIn targeting facets (e.g. locations, industries, job titles) |
Example Prompts
Here are some things you can say to your AI once connected:
"Find all contacts tagged 'new-lead' added this week and send them a welcome SMS"
"What appointments are booked on the Discovery calendar this Friday?"
"Check Sarah Johnson's conversation history and summarize the last 5 messages"
"Create a note on contact ID abc123 saying 'Called, left voicemail' and mark the task as complete"
"Move all open opportunities in the Onboarding pipeline older than 30 days to 'Lost'"
"Book an appointment for john@example.com tomorrow at 3pm on calendar XYZ"
"Enroll contact ID abc123 in the cold call workflow"
"Show me all unpaid invoices over 30 days old"
"List all users/team members in this location"
"What workflows do we have? Show me the names and IDs"
"Create a knowledge base called 'Product FAQ' and add 5 FAQs covering our pricing, refund policy, and onboarding steps"
"Crawl https://example.com and train our support knowledge base on every page under /docs"
"List all the FAQs in our knowledge base and update any that mention the old pricing"
"Show me the status of the last website crawl and train on all successfully discovered pages"Environment Variables Reference
Variable | Required | Description |
| ✅ Yes | Your GHL Private Integration Token |
| ✅ Yes | Your sub-account location ID |
That's it — just two variables. Workflow IDs, pipeline IDs, calendar IDs, and all other GHL resource identifiers are passed directly as parameters when you call the relevant tools. This keeps the server generic and usable across any project or use case.
Development
# Install dependencies
npm install
# Run in development mode (no build step needed)
npm run dev
# Type-check without building
npm run typecheck
# Build for production
npm run build
# Watch mode (rebuilds on file changes)
npm run build:watchProject Structure
ghl-mcp-server/
├── src/
│ ├── index.ts # MCP server entry point — registers all tools
│ ├── client.ts # GHL HTTP client (auth, request helper, error handling)
│ └── tools/
│ ├── contacts.ts # 21 contact tools
│ ├── conversations.ts # 9 conversation & messaging tools
│ ├── calendars.ts # 10 calendar & appointment tools
│ ├── opportunities.ts # 8 pipeline & deal tools
│ ├── workflows.ts # 2 workflow & campaign tools
│ ├── locations.ts # 16 location settings tools
│ ├── payments.ts # 12 payment & invoice tools
│ ├── social.ts # 8 social, media & trigger link tools
│ ├── emails.ts # 9 email builder & campaign tools
│ ├── funnels.ts # 3 funnel tools
│ ├── phone_numbers.ts # 5 phone number tools
│ ├── surveys.ts # 2 survey tools
│ ├── knowledge_base.ts # 14 knowledge base, FAQ & web crawler tools
│ ├── products.ts # 14 product, price & inventory tools
│ ├── product_collections.ts # 5 product collection tools
│ ├── product_reviews.ts # 5 product review tools
│ ├── product_store.ts # 3 storefront visibility & stats tools
│ ├── store.ts # 18 shipping & store settings tools
│ ├── affiliate_manager.ts # 4 affiliate tools
│ └── email_isv.ts # 1 email verification tool
├── dist/ # Compiled output (generated by npm run build)
├── .env.example # Environment variable template
├── package.json
├── tsconfig.json
└── README.mdAdding a new tool
Find the relevant module in
src/tools/Add a new entry to the exported array following the existing pattern:
{ name: "ghl_your_tool_name", description: "What this tool does and when to use it", inputSchema: z.object({ param: z.string().describe("Description of this parameter"), }), handler: async (args, config) => { try { const result = await ghlRequest("GET", "/your/endpoint", { token: config.token, params: { locationId: config.locationId, ...args }, }); return JSON.stringify(result, null, 2); } catch (e) { return formatError(e); } }, }Run
npm run typecheckto verify no type errorsSubmit a PR!
Troubleshooting
The server isn't showing up in my AI client
Make sure you ran
npm run buildand thedist/folder existsDouble-check the absolute path to
dist/index.jsin your configRestart your AI client after changing MCP config
Getting "GHL_PIT_TOKEN is not set" errors
Verify your
.envfile exists in theghl-mcp-server/directoryOr pass the env vars directly in your MCP client config (see setup instructions above)
Getting 401 Unauthorized from the API
Your PIT token may have expired or been revoked — generate a new one in GHL Settings → Private Integrations
Make sure the token is for the correct sub-account
Getting 422 or 400 errors
Check the
detailsfield in the error response — GHL usually explains what's wrongCommon causes: missing required fields, invalid phone number format (use E.164:
+15551234567), invalid date format (use ISO 8601)
Rate limit errors (429)
GHL enforces 100 requests per 10 seconds
For bulk operations, add a small delay between calls or process in batches
Contributing
Pull requests are welcome! Please:
Fork the repo
Create a feature branch (
git checkout -b feature/my-new-tool)Make your changes and run
npm run typecheckCommit and push, then open a PR
When adding new tools, follow the existing patterns in src/tools/ and keep the tool names prefixed with ghl_.
License
MIT © Business AI Specialist
Related
UltraLevel — a native macOS app for GoHighLevel. If this MCP server is how your AI agents talk to GHL, UltraLevel is how you do: contacts, conversations, deals, and tasks in a fast native workspace, with private on-device AI built in. Free 14-day trial.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseBqualityDmaintenanceA comprehensive MCP server that connects AI assistants to GoHighLevel CRM, enabling management of contacts, conversations, calendars, pipelines, payments, and more through 60+ tools.6439MIT
- AlicenseBqualityDmaintenanceMCP server for GoHighLevel API v2 that provides 50+ tools for CRM, billing, marketing, and operations workflows, enabling natural language interaction with contacts, opportunities, conversations, and more.501MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server that provides tools for managing GoHighLevel (GHL) conversations, tasks, and calendar appointments through AI assistants like Claude.2135MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for GoHighLevel sub-accounts, enabling management of CRM contacts, pipelines, calendars, invoices, and more via natural language.
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
LeadConnector / GoHighLevel MCP Pack — wraps the GoHighLevel CRM for AI agents.
A Model Context Protocol server for Wix AI tools
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/NerdSnipe-Inc/ghl-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server