← All posts

October 9, 2026 · 8 min read

GoHighLevel MCP Server: How to Connect Claude, ChatGPT and Cursor to HighLevel (2026)

Arslan Mumtaz

By Arslan Mumtaz, software engineer and GoHighLevel & AI automation specialist

The HighLevel MCP server lets AI assistants like Claude, ChatGPT and Cursor work directly with a GoHighLevel sub-account: look up contacts, check pipelines, read conversations and run actions, just by asking. This guide explains what it is, the two ways to connect, how to set it up in Claude and other tools, and how to use it without putting your CRM at risk.

1. What is the GoHighLevel MCP server?

MCP (Model Context Protocol) is an open standard that lets an AI assistant use outside tools. HighLevel runs an official MCP server on top of its API, so instead of writing code, you connect your AI assistant once and ask in plain English:

The assistant picks the right API operation, runs it with your permissions and reports back. It's the same idea as the GHL MCP servers people share on GitHub, but run and maintained by HighLevel.

2. Two ways to connect

HighLevel currently documents two versions of its MCP server:

MCP v2 (recommended)Original MCP endpoint
Endpoint/mcp/anthropic/v2 for Claude, /mcp/openai/v2/ for ChatGPT and Codex/mcp/
Sign-inOAuth: you log in, pick the sub-account and approve scopesPrivate Integration token plus a locationId header
ToolsFour unified tools (list locations, search operations, describe an operation, execute it) covering 550+ API operationsAbout 35 named tools across contacts, conversations, calendars, opportunities, payments, locations, blogs, email templates and social posts
Best forClaude and ChatGPT users who want broad access with a proper sign-inOther MCP clients (Cursor, Windsurf, custom agents) that send headers

All endpoints sit on https://services.leadconnectorhq.com.

3. How to connect GoHighLevel to Claude

Claude (web and desktop): add a custom connector in Claude's settings with the URL https://services.leadconnectorhq.com/mcp/anthropic/v2, then click Connect. A LeadConnector sign-in opens; log in, choose the sub-account and approve the permissions.

Claude Code (terminal): add it with one command, then run /mcp inside Claude Code to sign in:

claude mcp add --transport http leadconnector https://services.leadconnectorhq.com/mcp/anthropic/v2

ChatGPT and Codex use /mcp/openai/v2/ in the same way. Agency-wide access across many sub-accounts is still rolling out, so today you normally connect one sub-account at a time.

4. How to connect Cursor, Windsurf or a custom agent

For clients that send custom headers, use the original endpoint with a Private Integration token. Create the token in Settings → Private Integrations → Create new Integration, tick only the scopes the assistant needs, and copy it (it's shown once). Then add the server to your client's MCP config:

{
  "mcpServers": {
    "highlevel": {
      "type": "http",
      "url": "https://services.leadconnectorhq.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_PRIVATE_INTEGRATION_TOKEN",
        "locationId": "YOUR_SUB_ACCOUNT_ID"
      }
    }
  }
}

The tools available depend on the scopes you gave the token. If a tool is missing, the token usually lacks that scope. Custom agents built in n8n or LangGraph can connect the same way, or call the API directly.

5. MCP server vs API vs workflows: which to use?

UseWhen
MCP serverYou (or your team) ask questions and run one-off admin tasks through an AI assistant: reports, lookups, tagging, quick updates.
WorkflowsAnything that must happen the same way every time for customers: follow-up, reminders, routing. See 10 GoHighLevel automations.
API codeIntegrations, two-way syncs, client portals and high-volume jobs. See the GoHighLevel API guide.
Agent StudioAI steps inside GoHighLevel workflows. See the Agent Studio guide.

In short: MCP is for people working with the CRM through AI. Customer-facing automation should still run as workflows or code, because an AI assistant can phrase or choose things slightly differently each time.

6. Security: how to use it safely

HighLevel adds extra confirmation steps for sensitive operations in MCP v2, but the safest setup is still limited scopes plus a human checking anything that changes data.

7. Limitations to know

Endpoints, tool lists and setup screens are changing quickly, so check HighLevel's current MCP documentation before relying on any guide, this one included.

Want AI connected to your GoHighLevel account?

I'm Arslan Mumtaz, a software engineer who connects GoHighLevel to AI: MCP setups for teams, Agent Studio agents, Conversation AI and custom agents built on the API. See AI & automation and pricing, or start with a $97 audit.

Work with me

Still losing leads to voicemail or slow follow-up?

I build speed-to-lead, retention and AI automation systems in GoHighLevel, with custom code where the platform falls short.

More articles