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-gold Show pipeline snapshot with open and won value per stage"
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.
11 tools that turn Claude into your agency's GHL operator, via the official LeadConnector API v2. $39 once. No subscription. Your own API key (BYOK), fail-closed.
BYOK + fail-closed before price: Bring your own keys —
GHL_API_KEY+LOCATION_IDstay on your machine, fail-closed without them. Price $39 once (no subscription) — 11 tools + setup =12 requireGOLD_LICENSE_KEY.
Agencies pay GoHighLevel $97–497/month and still click through contacts one by one (gohighlevel.com/pricing, accessed 2026-08-22).
The best free MCP (mastanley13/GoHighLevel-MCP, 193 stars / 202 forks) has been abandoned since July 2025 with an unclear license. We rebuilt from scratch on the official v2 API — maintained, typed, bulk-first.
Related MCP server: ghl-mcp-server
Tool | What it does |
| Search contacts by query OR bulk-upsert up to 50 by email with tags |
| Move a deal to any pipeline stage / won / lost (+ value) |
| List threads unread-first; pull one thread to draft the reply |
| Calendars + upcoming appointments window |
| Add/remove tags across up to 25 contacts per call |
| Exact custom field keys/types so AI fills them right |
| AI summary of conversation (BYOK OpenAI or transcript) |
| Agency mode: list/inspect every sub-account your key reaches |
| What automation fires (name/status/stats) before you touch anything |
| Monday report: open + won value per stage, one call |
In your sub-account: Settings → Private Integrations → Create New Integration → copy the PIT token.
Env or ~/.gold-mcp/.env:
GOLD_LICENSE_KEY — your $29/$39 license key (PRO gate, fail-closed)
GHL_API_KEY — the PIT token
GHL_LOCATION_ID — default sub-account id (optional; agencies pass location_id per call or use gold_ghl_location_switcher)
Register in your MCP client:
{ "mcpServers": { "ghl-gold": { "command": "npx", "args": ["-y", "ghl-gold"], "env": { "GOLD_LICENSE_KEY": "...", "GHL_API_KEY": "...", "GHL_LOCATION_ID": "..." } } } }Read tools list freely; write tools are explicit and scoped (max 50 upserts / 25 tag-touches per call).
Sending conversations is intentionally NOT in v1 — drafts only, you press send in GHL.
Fail-closed: missing key/license ⇒ structured config error, never fake data.
One-time purchase, your keys stay on your machine, nothing phones home except GoHighLevel itself. See LICENSE + THIRD_PARTY_NOTICES.md.
We Build Bridges — bridges between AI and the software you already pay for.
List calendars and upcoming appointments for a sub-account. BYOK. PAID ONLY $39.
Inputs: days_ahead, location_id.
Search contacts by query, or bulk-upsert an array (email key) with tags — agency-scale contact ops the dead 193-star repo never finished. BYOK GHL_API_KEY. PAID ONLY $39.
Inputs: limit, query, action, confirm, +2 more.
POWER: pull a conversation thread and get a 5-line summary + sentiment + suggested next action. Uses YOUR OpenAI key when present (BYOK); without key returns the clean transcript for manual reading. BYOK GHL_API_KEY (+optional OPENAI_API_KEY). PAID ONLY $39.
Inputs: conversation_id (required), max_messages.
List recent conversations (unread first) or pull one thread's messages to draft a reply. BYOK. PAID ONLY $39.
Inputs: limit, location_id, conversation_id.
List a sub-account's custom fields (+folder) so AI fills them correctly instead of guessing keys. BYOK. PAID ONLY $39.
Inputs: location_id.
Agency mode: list every sub-account your key reaches, or inspect one (name/timezone/providers). BYOK. PAID ONLY $39.
Inputs: location_id.
Move one opportunity to a pipeline stage or won/lost. BYOK. PAID ONLY $39.
Inputs: opportunity_id (required), status, confirm, pipeline_id, +2 more.
One-call Monday report: pipelines with open/won value per stage across a sub-account. BYOK. PAID ONLY $39.
Inputs: location_id.
Add or remove tags on many contacts at once (loops upsert, 25 ids/call). BYOK. PAID ONLY $39.
Inputs: tags (required), contact_ids (required), remove, confirm, +1 more.
POWER: enroll up to 25 contacts into one workflow (loops the official add-to-workflow call). Nurture blast without CSV imports. BYOK GHL_API_KEY. PAID ONLY $39.
Inputs: contact_ids (required), workflow_id (required), confirm.
List workflows (name/status/stats) so AI knows what automation fires before touching contacts. BYOK. PAID ONLY $39.
Inputs: location_id.
SETUP CHECK for GoHighLevel Gold — run this FIRST. Shows license tier, which API keys are set vs missing (names only, never values), and the exact next step.
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 12 tools
Most tools target a distinct resource or action, such as workflows, contacts, opportunities, appointments, or locations. The main overlaps are between conversations_list_reply_draft and conversation_ai_summary (both pull threads) and between contacts_search_upsert_bulk and tags_bulk_apply (both touch contact records), but the descriptions are detailed enough to avoid serious ambiguity.
Almost all tools share a gold_ghl_ prefix, which creates a recognizable family, but the action placement is inconsistent: some names are verb-first (workflows_list, tags_bulk_apply), others are noun-final (appointments_calendar, custom_fields_map, pipeline_snapshot_report), and gold_setup_check drops the prefix entirely. The naming is readable but not predictable enough to guess a new tool's name reliably.
Twelve tools is a well-scoped size for a GoHighLevel operations server. Each tool covers a meaningful operational area without feeling redundant, and together they support a broad set of agency-style workflows.
The set covers the major operational loops: setup verification, sub-account discovery, contact upsert/search, tag management, custom field mapping, workflow listing/enrollment, conversation drafting, and pipeline reporting. Obvious gaps remain—such as opportunity creation/listing and appointment write operations—but most core GHL agency workflows are usable without external workarounds.
LeadConnector / GoHighLevel MCP Pack — wraps the GoHighLevel CRM for AI agents.
Automate GoHighLevel across CRM, messaging, calendars, marketing, e-commerce, and billing. Manage…
Manage SalesCloser AI sales agents, leads, campaigns and calls from your AI assistant.
Run your Brightly account from your AI agent: leads, conversations, appointments, sequences.