GoHighLevel MCP Server
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., "@GoHighLevel MCP Server find the contact with email john@example.com"
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
A Model Context Protocol (MCP) server that connects Claude to GoHighLevel's CRM platform.
Features
14 Tools across 4 domains:
Contact Management (5 tools)
Messaging & Conversations (4 tools)
Calendar & Appointments (3 tools)
Sales Opportunities (4 tools)
Related MCP server: GoHighLevel (GHL) MCP Server
Installation
git clone https://github.com/YOUR_USERNAME/gohighlevel-mcp-server.git
cd gohighlevel-mcp-server
npm installSetup
Get your GHL API token from GoHighLevel
Set the environment variable:
export GHL_API_TOKEN="your-api-token-here"Start the server:
npm startUsage with Claude Desktop
Add to ~/claude_desktop_config.json:
{
"mcpServers": {
"gohighlevel": {
"command": "bash",
"args": ["-c", "cd ~/projects/gohighlevel-mcp-server && export GHL_API_TOKEN='YOUR_TOKEN' && npm start"]
}
}
}Then restart Claude Desktop.
API Reference
Search Contacts - Search for contacts by query
Get Contact - Retrieve a specific contact
Create Contact - Add a new contact
Update Contact - Modify contact details
Add Tags - Assign tags to contacts
List Conversations - View contact conversations
Get Conversation - Retrieve conversation details
Send SMS - Send SMS messages
Send Email - Send email messages
List Appointments - View calendar appointments
Get Appointment - Retrieve appointment details
Create Appointment - Schedule new appointments
List Opportunities - View sales opportunities
Get Opportunity - Retrieve opportunity details
Create Opportunity - Add new sales opportunities
Update Opportunity - Modify opportunity status/value
Development
Built with:
TypeScript with strict mode
Zod for runtime validation
Axios for HTTP requests
MCP SDK for protocol implementation
License
MIT
Available Tools
20 toolsadd_contact_tagsB
Add tags to a contact
Inputs: tags (required), contact_id (required), response_format.
create_appointmentC
Create an appointment
Inputs: title (required), end_time (required), contact_id (required), start_time (required), +2 more.
create_contactC
Create a contact
Inputs: last_name (required), first_name (required), email, phone, +1 more.
create_opportunityC
Create an opportunity
Inputs: title (required), value (required), contact_id (required), probability (required), +2 more.
get_appointmentD
Get an appointment
Inputs: appointment_id (required), response_format.
get_contactC
Get a contact
Inputs: contact_id (required), response_format.
get_conversationC
Get a conversation
Inputs: conversation_id (required), response_format.
get_opportunityC
Get an opportunity
Inputs: opportunity_id (required), response_format.
get_workflowC
Get workflow details
Inputs: workflow_id (required), response_format.
get_workflow_statsC
Get workflow statistics
Inputs: workflow_id (required), response_format.
list_appointmentsC
List appointments
Inputs: limit, offset, response_format.
list_conversationsC
List conversations
Inputs: contact_id (required), limit, offset, response_format.
list_opportunitiesC
List opportunities
Inputs: limit, offset, response_format.
list_workflow_executionsC
Get workflow execution history
Inputs: workflow_id (required), limit, offset, response_format.
list_workflowsC
List all workflows/automations
Inputs: limit, offset, response_format.
search_contactsC
Search for contacts
Inputs: query (required), limit, offset, response_format.
send_emailC
Send email
Inputs: body (required), subject (required), contact_id (required), response_format.
send_smsC
Send SMS
Inputs: message (required), contact_id (required), response_format.
update_contactD
Update a contact
Inputs: contact_id (required), email, phone, last_name, +2 more.
update_opportunityD
Update an opportunity
Inputs: opportunity_id (required), title, value, status, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Each tool targets a distinct resource and action (e.g., contacts, appointments, opportunities, conversations, workflows, messaging). There is no overlap in purpose; tools like get_conversation vs list_conversations are clearly differentiated.
All tools follow a consistent verb_noun pattern in snake_case (e.g., create_contact, list_appointments, send_sms). The convention is uniform across all 20 tools.
20 tools is well-scoped for a CRM/automation platform. It covers core operations for contacts, appointments, opportunities, conversations, workflows, and messaging without being excessive or sparse.
The tool set has notable gaps: missing delete operations for contacts, appointments, opportunities, and conversations; no update for appointments or conversations; no remove_contact_tags. These omissions could hinder complete lifecycle management.
Maintenance
Related MCP Connectors
LeadConnector / GoHighLevel MCP Pack — wraps the GoHighLevel CRM for AI agents.
Manage your Elocuenti AI sales agents, CRM, campaigns and analytics from Claude.
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Solk CRM for Claude: accounts, pipeline, visits, quotes, orders and tickets with your permissions.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects Claude Desktop to GoHighLevel CRM with 269+ tools for comprehensive contact management, messaging, sales pipelines, appointments, marketing automation, and e-commerce operations through natural language.16 npmISC
- AlicenseNot gradedqualityBmaintenanceProvides access to over 460 tools within the GoHighLevel CRM, allowing AI assistants to manage contacts, opportunities, messaging, and business workflows through natural language.16 npm127ISC
- AlicenseNot gradedqualityDmaintenanceEnables Claude to manage GoHighLevel CRM contacts, pipelines, and workflows through natural language commands.91 npmMIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude Code with GoHighLevel CRM to manage contacts, pipelines, calendars, conversations, workflows, funnels, and forms via natural language.MIT