ghl-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ghl-mcp search for contacts with tag 'lead'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GoHighLevel MCP Server
ghl-mcp is a Model Context Protocol server for GoHighLevel API v2. It exposes contacts, opportunities, conversations, calendars, workflows, users, invoices, payments, social, forms, funnels, tasks, products, emails, campaigns, and documents as MCP tools over stdio so Claude Code, Cursor, Codex, OpenClaw, VS Code, and other MCP clients can work directly with GoHighLevel CRM data.
Features
50 MCP tools covering high-value GoHighLevel CRM, billing, marketing, and operations workflows
Built on
@modelcontextprotocol/sdkv1.xStrict TypeScript configuration
Zod-validated tool inputs with descriptions on every field
Automatic
locationIdinjection from environment variablesBasic request pacing to stay under GoHighLevel rate limits
Human-readable tool error payloads instead of raw stack traces
Related MCP server: CashClaw GHL MCP
Requirements
Node.js 18+
A GoHighLevel API token
A GoHighLevel location ID
Installation
Local development
npm install
npm run build
node dist/index.jsRun with npx
npx -y ghl-mcpConfiguration
Set these environment variables in the MCP client configuration:
GHL_API_TOKEN: Private Integration token or OAuth access tokenGHL_LOCATION_ID: GoHighLevel location or sub-account ID
The server sends these headers on every request:
Authorization: Bearer {GHL_API_TOKEN}
Content-Type: application/json
Version: 2021-07-28MCP Client Setup
Claude Code
Note:
claude mcp addregisters a local server name — it doesn't download from a registry. The part after--is the actual command that runs the server.
# After npm publish (recommended):
claude mcp add gohighlevel --scope user \
--env GHL_API_TOKEN="your-token" \
--env GHL_LOCATION_ID="your-location-id" \
-- npx -y ghl-mcp
# Local development (before publishing):
claude mcp add gohighlevel --scope user \
--env GHL_API_TOKEN="your-token" \
--env GHL_LOCATION_ID="your-location-id" \
-- node /absolute/path/to/ghl-mcp/dist/index.jsCursor / VS Code / Codex style config
{
"mcpServers": {
"gohighlevel": {
"command": "npx",
"args": ["-y", "ghl-mcp"],
"env": {
"GHL_API_TOKEN": "your-token-here",
"GHL_LOCATION_ID": "your-location-id"
}
}
}
}MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.jsTool List
Contacts
search_contacts: Search contacts by text, tag, pagination, or advanced filtersget_contact: Retrieve one contact by IDcreate_contact: Create a contactupdate_contact: Update contact fieldsdelete_contact: Delete a contactadd_contact_tags: Add tags to a contactremove_contact_tags: Remove tags from a contactget_contact_notes: List notes for a contactcreate_contact_note: Create a note on a contact
Opportunities
search_opportunities: Search deals by query, pipeline, stage, status, contact, or ownerget_opportunity: Retrieve one opportunity by IDcreate_opportunity: Create an opportunityupdate_opportunity: Update opportunity fieldsdelete_opportunity: Delete an opportunityupdate_opportunity_status: Change status toopen,won,lost, orabandonedlist_pipelines: List pipelines and fetch their stages
Conversations
search_conversations: Search conversationsget_conversation: Retrieve one conversation by IDget_conversation_messages: List messages in a conversationsend_message: Send SMS, email, WhatsApp, or similar messagescreate_conversation: Start a new conversation
Calendars
list_calendars: List calendarslist_events: List events or appointmentscreate_event: Create an eventget_available_slots: Retrieve available booking slots
Workflows
list_workflows: List workflowstrigger_workflow: Trigger a workflow for a contact
Users
list_users: List users in the configured locationget_user: Retrieve one user by ID
Invoices And Payments
list_invoices: List invoicescreate_invoice: Create an invoicelist_transactions: List payment transactionslist_orders: List payment orderslist_subscriptions: List subscriptions
Social
list_social_posts: List social postscreate_social_post: Create or schedule a social postlist_social_accounts: List connected social accountsget_social_stats: Retrieve social statistics
Forms And Funnels
list_forms: List formslist_funnels: List funnelslist_funnel_pages: List funnel pages
Tasks
list_tasks: List tasks for a contactcreate_task: Create a task for a contact
Products
list_products: List productslist_product_prices: List prices for a product
Emails
list_email_templates: List email templateslist_email_schedules: List scheduled emails
Campaigns
list_campaigns: List campaigns
Documents
list_contracts: List contracts or documentssend_contract_link: Send a contract link for signing
Development
npm run devBuild output goes to dist/.
Architecture
src/
├── index.ts
├── client.ts
├── types.ts
└── tools/
├── calendars.ts
├── campaigns.ts
├── contacts.ts
├── conversations.ts
├── documents.ts
├── emails.ts
├── forms.ts
├── invoices.ts
├── opportunities.ts
├── products.ts
├── social.ts
├── tasks.ts
├── users.ts
└── workflows.tsImplementation Notes
Most endpoints require
locationId. This server injects it automatically into request query strings and JSON bodies unless a value is already provided.The client applies a minimum delay between requests to reduce the chance of hitting GoHighLevel's rate limits.
Tool responses are returned as JSON text blocks with a short summary and the raw API payload.
Pipeline listing fetches pipeline stage details for each returned pipeline so agents get usable stage metadata in one call.
Example Workflows
Find a contact and add a note
Call
search_contactswithquery: "jane@company.com"Call
get_contactwith the selectedcontactIdCall
create_contact_notewith thecontactIdand note text
Create and advance an opportunity
Call
list_pipelinesto find the target pipeline and stage IDsCall
create_opportunitywithcontactId,pipelineId,pipelineStageId, andnameCall
update_opportunityorupdate_opportunity_statusas the deal progresses
Book an appointment
Call
get_available_slotswith acalendarIdand date rangeCall
create_eventwith the selected time slot and optionalcontactId
Publishing
npm publish --access publicThe published package installs the ghl-mcp binary from dist/index.js.
Available Tools
50 toolsadd_contact_tagsC
Add one or more tags to a GoHighLevel contact.
Inputs: contactId (required), tags (required).
create_contactB
Create a new GoHighLevel contact.
Inputs: firstName, lastName, name, email, +7 more.
create_contact_noteB
Create a note on a GoHighLevel contact.
Inputs: contactId (required), body (required), userId.
create_conversationC
Start a new GoHighLevel conversation.
Inputs: contactId (required), channel (required), message, assignedTo.
create_eventB
Create a GoHighLevel appointment or calendar event.
Inputs: calendarId (required), title (required), startTime (required), endTime (required), +4 more.
create_invoiceB
Create a GoHighLevel invoice.
Inputs: contactId (required), title (required), amount, currency, +5 more.
create_opportunityC
Create a new GoHighLevel opportunity.
Inputs: contactId (required), pipelineId (required), pipelineStageId (required), name (required), +4 more.
create_social_postB
Create or schedule a GoHighLevel social post.
Inputs: accountIds (required), text (required), scheduledAt, mediaUrls, +1 more.
create_taskC
Create a GoHighLevel task for a contact.
Inputs: contactId (required), title (required), dueDate (required), body, +2 more.
delete_contactB
Delete a GoHighLevel contact.
Inputs: contactId (required).
delete_opportunityB
Delete a GoHighLevel opportunity.
Inputs: opportunityId (required).
get_available_slotsC
Get available GoHighLevel booking slots for a calendar.
Inputs: calendarId (required), startDate (required), endDate (required), timezone.
get_contactA
Get a single GoHighLevel contact with full details.
Inputs: contactId (required).
get_contact_notesB
List notes attached to a GoHighLevel contact.
Inputs: contactId (required).
get_conversationB
Get a single GoHighLevel conversation by ID.
Inputs: conversationId (required).
get_conversation_messagesB
List messages in a GoHighLevel conversation.
Inputs: conversationId (required), limit.
get_opportunityB
Get a single GoHighLevel opportunity by ID.
Inputs: opportunityId (required).
get_social_statsC
Get GoHighLevel social account or post statistics.
Inputs: accountId, startDate, endDate, platform.
get_userA
Get a single GoHighLevel user by ID.
Inputs: userId (required).
list_calendarsB
List GoHighLevel calendars for the configured location.
Inputs: groupId.
list_campaignsC
List GoHighLevel campaigns for the configured location.
Inputs: status, search.
list_contractsC
List GoHighLevel contracts or documents.
Inputs: contactId, status, altId.
list_email_schedulesB
List GoHighLevel scheduled emails.
Inputs: campaignId, status.
list_email_templatesB
List GoHighLevel email builder templates.
Inputs: campaignId, folderId, search.
list_eventsC
List GoHighLevel calendar events or appointments.
Inputs: calendarId, startTime, endTime.
list_formsB
List GoHighLevel forms for the configured location.
Inputs: name.
list_funnel_pagesC
List GoHighLevel funnel pages.
Inputs: funnelId, name.
list_funnelsB
List GoHighLevel funnels for the configured location.
Inputs: name.
list_invoicesC
List GoHighLevel invoices for the configured location.
Inputs: status, contactId, altId.
list_ordersC
List GoHighLevel payment orders.
Inputs: contactId, status, altId.
list_pipelinesA
List GoHighLevel pipelines and include their stages.
Inputs: no named parameters.
list_product_pricesB
List GoHighLevel prices for a product.
Inputs: productId (required), currency.
list_productsB
List GoHighLevel products for the configured location.
Inputs: altId, search.
list_social_accountsB
List connected GoHighLevel social accounts.
Inputs: platform.
list_social_postsC
List GoHighLevel social posts for the configured location.
Inputs: accountId, status, startDate, endDate.
list_subscriptionsC
List GoHighLevel subscriptions.
Inputs: contactId, status, altId.
list_tasksA
List GoHighLevel tasks for a contact.
Inputs: contactId (required), status.
list_transactionsC
List GoHighLevel payment transactions.
Inputs: contactId, subscriptionId, orderId, altId.
list_usersB
List users or team members in the configured GoHighLevel location.
Inputs: role.
list_workflowsC
List GoHighLevel workflows available in the configured location.
Inputs: status.
remove_contact_tagsC
Remove one or more tags from a GoHighLevel contact.
Inputs: contactId (required), tags (required).
search_contactsA
Search for GoHighLevel contacts by name, email, phone, tag, or advanced filters.
Inputs: query, tag, limit, startAfterId, +2 more.
search_conversationsC
Search GoHighLevel conversations.
Inputs: query, contactId, assignedTo, status, +1 more.
search_opportunitiesC
Search GoHighLevel opportunities in a pipeline.
Inputs: query, pipelineId, pipelineStageId, status, +2 more.
send_contract_linkC
Send a GoHighLevel contract link for signing.
Inputs: documentId (required), contactId, email, phone, +1 more.
send_messageC
Send an SMS, email, or other GoHighLevel conversation message.
Inputs: type (required), message (required), contactId, conversationId, +4 more.
trigger_workflowB
Trigger a GoHighLevel workflow for a contact.
Inputs: workflowId (required), contactId (required), eventData.
update_contactB
Update fields on an existing GoHighLevel contact.
Inputs: contactId (required), firstName, lastName, name, +8 more.
update_opportunityC
Update an existing GoHighLevel opportunity.
Inputs: opportunityId (required), contactId, pipelineId, pipelineStageId, +5 more.
update_opportunity_statusB
Change the status of a GoHighLevel opportunity.
Inputs: opportunityId (required), status (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 50 tools
Each tool targets a distinct resource and action, with clear names and descriptions. There is no ambiguity between tools like list_contacts and search_contacts or between various CRUD operations for different entities.
All tool names follow a consistent verb_noun pattern using lowercase and underscores. Verbs like create, get, list, update, delete, search are used uniformly across the set.
With 50 tools, the set is overly large, containing many list_* tools that could be consolidated or reduced. The number exceeds the recommended upper bound for a well-scoped server, making it harder for agents to navigate.
The tool set covers core CRUD for contacts and opportunities, but lacks CRUD completeness for other entities like invoices (only create and list, no get/update/delete) and conversations (no delete). Some notable gaps exist.
Related MCP Connectors
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
LeadConnector / GoHighLevel MCP Pack — wraps the GoHighLevel CRM for AI agents.
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.6437 npm1MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for GoHighLevel with 82 live-tested tools, enabling CRM operations like contact management, appointments, invoices, and workflows via natural language.Creative Commons Attribution Non Commercial 4.0 International
- FlicenseNot gradedqualityDmaintenanceMCP server for GoHighLevel sub-accounts, enabling management of CRM contacts, pipelines, calendars, invoices, and more via natural language.-
- AlicenseNot gradedqualityCmaintenanceA comprehensive MCP server that connects AI systems to GoHighLevel CRM, providing 269+ tools for contact management, messaging, calendar, sales, and automation.10 npmMIT