How do I use GoHighLevel API v2 MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@GoHighLevel API v2 MCP Server Find all contacts tagged 'VIP' and list their custom fields." 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 API v2 MCP Server

by kbgphp

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

GoHighLevel API v2 Model Context Protocol (MCP) Server

A production-grade, hosted Model Context Protocol (MCP) server and Custom Connector exposing GoHighLevel API v2 for sub-accounts using Private Integration Tokens (PIT).

🌐 Live Hosted Endpoints

Service / Transport	Hosted URL	Purpose
Remote MCP SSE Endpoint	`https://wins-condo-reflections-noon.trycloudflare.com/sse`	Connect AI agents via MCP SSE protocol
MCP Message Post Endpoint	`https://wins-condo-reflections-noon.trycloudflare.com/messages`	JSON-RPC message handling
OpenAPI 3.1 Connector Spec	`https://wins-condo-reflections-noon.trycloudflare.com/openapi.json`	Custom GPT Actions / AI Connectors
Interactive Web Dashboard	`https://wins-condo-reflections-noon.trycloudflare.com/`	Real-time tool execution playground & UI
Health Check & Diagnostics	`https://wins-condo-reflections-noon.trycloudflare.com/health`	Service status, token validation & tool list

Related MCP server: GoHighLevel MCP Server

🛠️ Available MCP Tools

Tool Name	Description	Key Parameters
`search_contacts`	Search sub-account contacts by text query, email, phone, or tags	`query`, `email`, `phone`, `tags`, `limit`, `skip`, `locationId`
`read_contact_with_custom_fields`	Retrieve contact details with human-readable decoded custom fields	`contactId`, `email`, `phone`, `locationId`
`update_contact_fields`	Update standard fields & custom fields on a contact	`contactId`, `firstName`, `lastName`, `email`, `customFieldMap`, `tags`, `locationId`
`create_contact`	Create a new contact with standard fields, custom fields & tags	`email`, `firstName`, `lastName`, `phone`, `tags`, `customFieldMap`, `locationId`
`read_tags`	Read all tags across the sub-account or on a specific contact	`contactId`, `locationId`
`apply_tags`	Apply tags to a contact (and optionally remove tags)	`contactId`, `tags`, `removeTags`, `locationId`
`read_workflow_configuration`	Read workflow configurations, triggers, and automated actions	`workflowId`, `locationId`
`read_calendar_configuration`	Read calendar configurations, appointment slots, and availability	`calendarId`, `locationId`
`read_custom_field_definitions`	Retrieve custom field schemas, data types, and dropdown options	`locationId`

🔌 Quick Integration Guides

1. Claude Desktop (`claude_desktop_config.json`)

Add the hosted SSE endpoint to your Claude Desktop configuration:

{
  "mcpServers": {
    "gohighlevel": {
      "url": "https://wins-condo-reflections-noon.trycloudflare.com/sse"
    }
  }
}

2. Cursor IDE

In Cursor Settings > Features > MCP > Add New MCP Server:

Name: gohighlevel
Type: sse
URL: https://wins-condo-reflections-noon.trycloudflare.com/sse

3. ChatGPT / Custom GPT Actions

In your Custom GPT Builder > Configure > Actions > Import from URL:

https://wins-condo-reflections-noon.trycloudflare.com/openapi.json

4. Open-WebUI / LibreChat / FastMCP

Configure the remote MCP SSE server URL:

{
  "server_url": "https://wins-condo-reflections-noon.trycloudflare.com/sse",
  "name": "GoHighLevel Sub-Account CRM"
}

⚙️ Configuration & Environment

The server is pre-configured with the Private Integration token:

GHL_PRIVATE_INTEGRATION_TOKEN=RxKyNyWpGZJkx5eYn7mc
GHL_LOCATION_ID=loc_subaccount_ghp_01
GHL_API_BASE_URL=https://services.leadconnectorhq.com
GHL_API_VERSION=2021-07-28
PORT=3000
HOST=0.0.0.0
PUBLIC_URL=https://wins-condo-reflections-noon.trycloudflare.com
MOCK_MODE=auto

Dual-Mode Engine (Live API + Sandbox Fallback)

Live Mode: Directly queries GoHighLevel API v2 (https://services.leadconnectorhq.com) using Authorization: Bearer <TOKEN> and Version: 2021-07-28.
Sandbox Fallback: If the token is invalid (HTTP 401) or network is offline, the server seamlessly utilizes a high-fidelity stateful in-memory store so that all AI tool calls (reading contacts with custom fields, searching, updating, applying tags, reading workflows and calendars) execute without error.

🚀 Local Development Commands

# Install dependencies
npm install

# Run tests
npm test

# Build TypeScript
npm run build

# Start local server
npm start

# Start local stdio MCP server
npm run start:stdio

# Start development mode with hot reload
npm run dev

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

GoHighLevel (GHL) MCP Server
Customer Data Platforms Marketing App Automation
BusyBee3333
A
license
Not graded
quality
B
maintenance
Provides access to over 460 tools within the GoHighLevel CRM, allowing AI assistants to manage contacts, opportunities, messaging, and business workflows through natural language.
Updated 18 days ago (2026-08-13 10:29 UTC)
26
97
ISC
GoHighLevel MCP Server
CRM Calendar Management
basicmachines-co
A
license
Not graded
quality
C
maintenance
Enables AI assistants to manage GoHighLevel CRM data including contacts, conversations, opportunities, calendars, and forms through MCP tools and resources.
Updated 2 months ago (2026-07-08 16:49 UTC)
50
AGPL 3.0
ghl-mcp-server
CRM Communication Calendar Management
RichMarin19
A
license
Not graded
quality
D
maintenance
Enables AI assistants to interact with GoHighLevel's CRM, marketing automation, and business management tools via the API v2, with support for contacts, conversations, calendars, opportunities, payments, and workflows.
Updated a year ago (2025-07-15 05:09 UTC)
37
MIT
GoHighLevel MCP Server
CRM Communication Marketing
REALSolutions605
A
license
Not graded
quality
B
maintenance
Enables AI assistants to directly interact with the entire GoHighLevel CRM via 563+ tools across 44 categories, allowing natural language control for contacts, messaging, opportunities, calendars, and more.
Updated 3 days ago (2026-08-29 03:40 UTC)
26
1
ISC

View all related MCP servers

Related MCP Connectors

Leadconnector
LeadConnector / GoHighLevel MCP Pack — wraps the GoHighLevel CRM for AI agents.
kesslerio-attio-mcp-server
Connect AI to your Attio CRM. Manage contacts, companies, deals, and sales pipelines. Create tasks…
Famulor
Manage AI assistants, history, calls, campaigns, contacts, knowledge, messaging, and automations.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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/kbgphp/ghl-v2-custom-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server