convez.ai
MCP ServerIntegração & APIsIntermediário
BusyBee3333

GoHighLevel MCP Server

BusyBee3333/Go-High-Level-MCP-2026-Complete

Integração MCP para GoHighLevel CRM com ferramentas de workflow curadas

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que expõe operações da API GoHighLevel como ferramentas para agentes de IA e clientes Claude/Cursor. Fornece integração CRM com suporte a múltiplos perfis de ferramentas (curado, estável, completo) e setup simplificado para agentes.

Instalação

$npx convez-ai BusyBee3333/Go-High-Level-MCP-2026-Complete

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
128
Forks
87
Acompanhando
3
Saúde
42%
Último commit
há 2 meses
Versão
—
Issues abertas
2
Contribuidores
5

Casos de uso

  • Automatizar fluxos de contatos e leads em GoHighLevel via agentes IA
  • Integrar operações CRM em aplicações Claude/Cursor/Codex
  • Gerenciar campanhas e automações sem sair do seu MCP client

Veredito

MCP server sólido e bem documentado para GoHighLevel com setup acessível e perfis de ferramentas bem pensados. Adequado para quem já usa GHL e quer automação via agentes, mas requer token de API GoHighLevel válido e conta ativa na plataforma.

README

A tradução para o português deste README ainda está na fila.

GoHighLevel MCP Server

Model Context Protocol server for GoHighLevel. It exposes GHL API operations as MCP tools over stdio, Streamable HTTP, legacy SSE, and optional MCP Apps.

New here? Start with QUICKSTART.md.

Using an AI/dev agent? Give it AGENT_SETUP.md and say: "Set this up for my MCP client using the curated profile. Ask me for credentials if needed. Do not run write tools."

5-Minute Quickstart

Requirements:

  • Node 20+
  • A GoHighLevel private integration token or OAuth access token
  • A GoHighLevel Location ID
npm install
cp .env.example .env
npm run build
npm run doctor
npm run configure:codex

Add your credentials to .env:

GHL_API_KEY=your_private_integration_api_key
GHL_LOCATION_ID=your_location_id
GHL_BASE_URL=https://services.leadconnectorhq.com
GHL_API_VERSION=2023-02-21

GHL_API_VERSION=2023-02-21 is the current HighLevel API Version header used by official docs. It is not the project year, and it should not be changed to 2026 unless HighLevel publishes a new required API version.

Then verify live auth:

npm run auth-check

Setup Commands

npm run setup                 # Create .env if needed, build, and print next steps
npm run first-run             # One-command beginner setup/readiness flow
npm run connect               # Setup plus client config generation
npm run ready                 # Fast readiness check
npm run demo                  # Print MCP Apps demo preview instructions
npm run explain-error -- "Location is not active"
npm run doctor                # Human-readable setup check
npm run doctor -- --json      # Agent-readable setup check
npm run agent:check           # Safe validation for AI/dev agents
npm run auth-check            # Read-only GHL token/location check

Missing credentials are reported as needsHumanAction, not as a broken install. This lets agents build and configure the repo without inventing secrets.

MCP Client Config

Beginner configs use GHL_TOOL_PROFILE=curated so agents see the high-level workflow tools first.

npm run configure:codex
npm run configure:claude
npm run configure:cursor
npm run configure:windsurf

Advanced examples:

node scripts/ghl-mcp.mjs configure codex --profile stable
node scripts/ghl-mcp.mjs configure codex --profile full
node scripts/ghl-mcp.mjs configure codex --profile curated --json

Tool Profiles

  • curated - recommended for agents; high-level CRM workflows with confirmation queues.
  • stable - production-friendly; official, supplemental, curated, and legacy-compatible tools.
  • full - everything.
  • official - official OpenAPI and live-docs supplemental tools.
  • raw - endpoint-level tools only.

Run

npm run start:stdio       # Desktop MCP clients
npm run start:http        # Streamable HTTP at /mcp
npm run start:legacy      # Legacy SSE at /sse

HTTP also exposes:

  • GET /health
  • GET /capabilities
  • GET /tools
  • POST /execute
  • POST /tools/call

MCP Apps

npm run apps:setup
npm run apps:preview

Open http://localhost:3001/preview. Without GHL credentials, the apps use preview/demo states and tell you exactly which env vars are missing.

Tool Discovery

npm run tools:list
npm run tools:list -- --search contacts
npm run tools:list -- --category contacts
npm run tools:list -- --stability official
npm run tools:list -- --access write
npm run tools:list -- --destructive
npm run tools:explorer

The static explorer is docs/tool-explorer.html.

High-Level Agent Tools

Start agents with the curated profile and prefer these high-level tools before raw endpoints:

  • crm_location_overview
  • crm_daily_briefing
  • crm_search_everything
  • crm_next_best_actions
  • crm_get_next_page
  • crm_prepare_contact_followup
  • crm_prepare_lead_reactivation
  • crm_prepare_missed_call_response
  • crm_prepare_pipeline_cleanup
  • crm_prepare_review_request_batch
  • crm_prepare_invoice_followup

Docs

Update History

DateUpdate #Included
2026-06-112Simplicity and power layer: easy setup commands, safe config writing, grouped live smoke checks, and high-level curated CRM agent tools. See UPDATE_LOG.md for the full permanent update description.
2026-06-111Onboarding and agent setup overhaul. See UPDATE_LOG.md for the full permanent update description.

API Coverage

  • Official GHL endpoints parsed: 590
  • Official endpoint coverage: 590 / 590
  • Generated official endpoint tools: 238
  • MCP tools in registry: 848
  • Local-only endpoint references tracked for review: 253

Generated coverage artifacts live in docs/. Run npm run scan:ghl-api only when intentionally refreshing API coverage.

Safety

  • .env is ignored and must never be committed.
  • test-tool refuses write/destructive tools unless --confirm is supplied.
  • Curated workflow tools stage confirmation queues for writes.
  • Use curated for beginners and stable for production.
Ver o original no GitHub

Bom para

Relacionados