Guide

GoHighLevel MCP Servers: What They Are and How to Choose One

How Model Context Protocol servers connect AI assistants to GoHighLevel, what the official server covers, and where the community and commercial options differ.

Last updated

What is a GoHighLevel MCP server?

A GoHighLevel MCP server is an HTTP service that exposes your GoHighLevel account to an AI assistant as a set of callable tools, using the Model Context Protocol. Instead of pasting API responses into a chat window, you point the assistant at a URL and it can look up contacts, read conversations, move opportunities, or book appointments directly.

MCP is an open standard for connecting language models to external data and tools. The server advertises the tools it has; the client — Claude Desktop, Claude Code, Cursor, n8n, or your own agent — discovers them at connection time and decides when to call them. You never define the tool list yourself, and you never write glue code for individual API calls.

The consequence that matters is that the server, not the model, decides what is reachable. Two servers pointed at the same GoHighLevel account can differ substantially depending on which operations they expose, what they know about request shapes, and what they do on your behalf between the model's request and GoHighLevel's API.

Terminology

HighLevel, GoHighLevel, and LeadConnector refer to the same platform in different contexts. The API host is services.leadconnectorhq.com, which is why the official MCP endpoint carries the LeadConnector name.

What does the official HighLevel MCP server do?

HighLevel operates a first-party MCP server, and its current recommended endpoint exposes six tools that together reach 625 operations across 40 product domains, filtered by the permissions on your grant. That figure is HighLevel's own, published in its multi-account support article (last modified 6 August 2026).

Rather than registering one tool per API operation, it uses a discovery pattern — a small fixed set of tools that look up and then run the right operation. These are the six the endpoint returned on 7 August 2026:

ToolWhat it does
searchFind records by name, email, phone, tag, or similar criteria
fetchHydrate full details for record IDs returned by search
search_operationsFind an executable API operation by intent
describe_operationInspect one operation's params, scopes, and a sanitized example
execute_operationRun one operation after server-side scope and safety checks
list_locationsList the sub-accounts this connection can operate on

Keeping the tool list short matters because every registered tool consumes space in the model's prompt. It also means new GoHighLevel operations become reachable without you changing any configuration — the registry the discovery tools search is generated on HighLevel's side.

Authentication is either a one-click OAuth sign-in through HighLevel's consent flow, or a Private Integration Token passed as Authorization: Bearer pit-your-token. Agencies can authorize several sub-accounts and switch between them inside one conversation using list_locations. Our authentication guide covers which of the two grants each part of the API accepts.

Which official endpoint should you use?

HighLevel documents two. Use the per-client v2 endpoint if your client has one — it is the one with the full operation catalog. The tool counts below come from a live tools/list call against each endpoint on 7 August 2026, not from documentation.

EndpointTools returnedUse when
/mcp/anthropic/v26 discovery tools, documented as reaching 625 operations across 40 domainsYou are on Claude — claude.ai, Claude Desktop, or Claude Code
/mcp/36 named tools across 9 domains — blogs, calendars, contacts, conversations, emails, locations, opportunities, payments, social media postingAny other HTTP-based MCP client, including n8n

Both are hosted at services.leadconnectorhq.com. HighLevel lists dedicated /mcp/{client}/v2 endpoints for OpenAI (ChatGPT and Codex), Cursor, Windsurf, and VS Code as planned rather than available, so on those clients the general endpoint is today's option.

This surface moves — check the date on any number

The general endpoint listed 21 tools when we first crawled HighLevel's documentation in September 2025 and 36 when we re-read it in April 2026, which is still the count today. The v2 endpoint and its discovery tools did not exist in either of those reads. Any tool count you find in a blog post is a snapshot of one date; run the tools/list call at the bottom of this page to see what your own grant actually reaches.

Why do third-party GoHighLevel MCP servers exist?

Because an MCP server can do work between the model and the API, and different servers choose different work to do. Three gaps account for most of the community and commercial options.

  • Schema knowledge. Knowing an endpoint exists is not knowing that calendars/get-calendar-events requires startTime and endTime as Unix epoch milliseconds, plus exactly one of calendarId, userId, or groupId — omit all three and the call returns 422. A model that guesses spends a round trip finding out.
  • Batch work. Importing 400 contacts one tool call at a time is 400 round trips through the model, each billed as tokens and each independently able to fail. Servers that fan out request-side turn that into one call.
  • Surfaces outside the public API. The workflow builder in particular has no documented public write API, so reading or editing a workflow is not something a server can offer by wrapping published endpoints.

Hylo — this site — is one of the commercial options, built around the first two. It indexes 645 GoHighLevel endpoints, 576 of them from GoHighLevel's official specification, and layers hand-written request-shape guidance on top of the raw schemas. You can browse that index without an account, and the bulk operations guide covers the batching question in detail.

How to choose one

Start with the official server. It is first-party, its operation catalog is the broadest available, it tracks GoHighLevel's API as that API changes, and OAuth sign-in means you never handle a token by hand. For conversational CRM work — look up this contact, move that opportunity, check next week's calendar — it is the straightforward answer, and nothing below argues otherwise.

Consider adding or substituting another server when:

  • You import or update records in volume. Ask where batching happens — on the server or in the model's context — and what the server does when GoHighLevel returns HTTP 429.
  • Your assistant writes code against the API. Then you want request and response schemas as retrievable data, not only as operations something else executes.
  • You need the workflow builder. Check explicitly whether reading and editing workflows is supported. Most servers, including the official one's documented catalog, cover the public REST API rather than the builder.
  • You are not using an AI client at all. Some servers also expose a plain REST surface, which an MCP endpoint by itself does not.

The side-by-side comparison puts the checkable numbers in one table. For self-hosted community servers the questions are the ordinary ones: who operates the host your token is sent to, how stored credentials are encrypted, and whether the project is maintained.

Common questions

Is the GoHighLevel MCP server free?

HighLevel's published MCP documentation does not state a plan requirement or a separate charge for the MCP server. It authenticates with a Private Integration Token or an OAuth grant from your existing account, so access follows whatever your account and token scopes already allow. Confirm current commercial terms with HighLevel directly.

Do I need to write code to use a GoHighLevel MCP server?

No. MCP servers are configured, not coded. You add an HTTP URL and an authorization header to your AI client's MCP configuration, and the client discovers the available tools automatically when it connects.

Can an MCP server write to my GoHighLevel account, or only read?

It can write, within the limits of your token. The scopes attached to your Private Integration Token or OAuth grant determine which operations are reachable, so a token carrying only read scopes yields a read-only connection.

Does a GoHighLevel MCP server work with tools other than Claude?

MCP is an open protocol, so any client implementing it can connect. HighLevel documents its general endpoint as working with any HTTP-based MCP client, including n8n, and lists dedicated per-client endpoints for OpenAI, Cursor, Windsurf, and VS Code as planned.

How many tools does the official GoHighLevel MCP server expose?

It depends on the endpoint. A live tools/list call on 7 August 2026 returned 36 tools across 9 domains from the general endpoint, and 6 tools from the Claude v2 endpoint. The 6 are discovery tools that reach a much larger catalog, which HighLevel documents as 625 operations across 40 domains.

List the tools your grant actually reaches

curl -s -X POST https://services.leadconnectorhq.com/mcp/ \
  -H "Authorization: Bearer pit-your-token" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

The response is a server-sent event stream whose data: line carries the tool list — the fastest way to see the real current surface rather than a documented one. Swap the path for /mcp/anthropic/v2 to compare the two endpoints. Omitting the Accept header is the usual cause of a confusing failure here.