Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Ghl MCP Server

de northrosetechversión 1.0.1i★ 1iSe ejecuta en tu computadora
Nombre en el registroio.github.northrosetech/ghl-mcp-server

Cómo instalar

What it does

GoHighLevel CRM for AI agents. 60+ tools for contacts, messaging, calendars, and payments.

  • Connects Se ejecuta en tu computadora
  • Account or key Needs GHL_API_KEY · 1 setting to fill in (GHL_LOCATION_ID)
  • Category Marketing y redes sociales

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 2/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de Ghl MCP Server (créala en el sitio del autor) · 1 ajuste(s) que rellenar (GHL_LOCATION_ID) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Ghl MCP Server

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • GHL_LOCATION_ID GoHighLevel sub-account (location) ID. Visible in the URL when viewing a sub-account.

    Las descripciones siguen en el inglés original.

  4. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  5. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "ghl": {
          "command": "npx",
          "args": [
            "-y",
            "@northrosetech/ghl-mcp-server"
          ],
          "env": {
            "GHL_API_KEY": "your-value",
            "GHL_LOCATION_ID": "your-value"
          }
        }
      }
    }

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Cierra Claude y vuelve a abrirlo

  7. Pruébalo

    Usa Ghl MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Ghl MCP Server o muestra una herramienta de Ghl MCP Server en la respuesta, ya está conectado

4 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • GHL_BASE_URL GHL API base URL. The default works for all standard installs. · valor por defecto https://services.leadconnectorhq.com
  • GHL_API_VERSION Value for the GHL API Version header. · valor por defecto 2021-07-28
  • TRANSPORT Transport mode: 'stdio' for Claude Desktop / Claude Code, 'http' for N8N and remote clients. · valor por defecto stdio
  • LOG_LEVEL Log verbosity. · valor por defecto info

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Ghl MCP Server

Ghl MCP Server se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Ghl MCP Server

  • Necesitas una clave de Ghl MCP Server (créala en el sitio del autor) · 1 ajuste(s) que rellenar (GHL_LOCATION_ID) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Necesitas una clave de Ghl MCP Server (créala en el sitio del autor) · 1 ajuste(s) que rellenar (GHL_LOCATION_ID) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de Ghl MCP Server (créala en el sitio del autor) · 1 ajuste(s) que rellenar (GHL_LOCATION_ID) · Instala Node.js en tu computadora primero (una sola vez)
  • Necesitas una clave de Ghl MCP Server (créala en el sitio del autor) · 1 ajuste(s) que rellenar (GHL_LOCATION_ID) · Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Marketing y redes sociales que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de Ghl MCP Server (créala en el sitio del autor) · 1 ajuste(s) que rellenar (GHL_LOCATION_ID) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Ghl MCP Server

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • GHL_LOCATION_ID GoHighLevel sub-account (location) ID. Visible in the URL when viewing a sub-account.

    Las descripciones siguen en el inglés original.

  4. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  5. Pega este comando y pulsa Enter

    claude mcp add --scope user ghl --env GHL_API_KEY=your-value --env GHL_LOCATION_ID=your-value -- npx -y @northrosetech/ghl-mcp-server

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Escribe /mcp en Claude Code

    Deberías ver Ghl MCP Server en la lista como conectado

  7. Pruébalo

    Usa Ghl MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Ghl MCP Server o muestra una herramienta de Ghl MCP Server en la respuesta, ya está conectado

4 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • GHL_BASE_URL GHL API base URL. The default works for all standard installs. · valor por defecto https://services.leadconnectorhq.com
  • GHL_API_VERSION Value for the GHL API Version header. · valor por defecto 2021-07-28
  • TRANSPORT Transport mode: 'stdio' for Claude Desktop / Claude Code, 'http' for N8N and remote clients. · valor por defecto stdio
  • LOG_LEVEL Log verbosity. · valor por defecto info

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de Ghl MCP Server (créala en el sitio del autor) · 1 ajuste(s) que rellenar (GHL_LOCATION_ID) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Ghl MCP Server

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • GHL_LOCATION_ID GoHighLevel sub-account (location) ID. Visible in the URL when viewing a sub-account.

    Las descripciones siguen en el inglés original.

  4. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  5. Escribe tu clave

    En la configuración de Ghl MCP Server, GHL_API_KEY, GHL_LOCATION_ID está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Abre el chat de IA de Cursor en modo Agent

  7. Pruébalo

    Usa Ghl MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Ghl MCP Server o muestra una herramienta de Ghl MCP Server en la respuesta, ya está conectado

4 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • GHL_BASE_URL GHL API base URL. The default works for all standard installs. · valor por defecto https://services.leadconnectorhq.com
  • GHL_API_VERSION Value for the GHL API Version header. · valor por defecto 2021-07-28
  • TRANSPORT Transport mode: 'stdio' for Claude Desktop / Claude Code, 'http' for N8N and remote clients. · valor por defecto stdio
  • LOG_LEVEL Log verbosity. · valor por defecto info

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de Ghl MCP Server (créala en el sitio del autor) · 1 ajuste(s) que rellenar (GHL_LOCATION_ID) · Instala Node.js en tu computadora primero (una sola vez)

  1. Instala Node.js

    Una sola vez; sirve para todos los servidores que necesitan Node.js

    Abrir la página de descarga de Node.js ↗

  2. Regístrate y crea una clave de Ghl MCP Server

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • GHL_LOCATION_ID GoHighLevel sub-account (location) ID. Visible in the URL when viewing a sub-account.

    Las descripciones siguen en el inglés original.

  4. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  5. Escribe tu clave

    En la configuración de Ghl MCP Server, GHL_API_KEY, GHL_LOCATION_ID está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  6. Abre el chat de IA de VS Code en modo Agent

  7. Pruébalo

    Usa Ghl MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Ghl MCP Server o muestra una herramienta de Ghl MCP Server en la respuesta, ya está conectado

4 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • GHL_BASE_URL GHL API base URL. The default works for all standard installs. · valor por defecto https://services.leadconnectorhq.com
  • GHL_API_VERSION Value for the GHL API Version header. · valor por defecto 2021-07-28
  • TRANSPORT Transport mode: 'stdio' for Claude Desktop / Claude Code, 'http' for N8N and remote clients. · valor por defecto stdio
  • LOG_LEVEL Log verbosity. · valor por defecto info

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Ghl MCP Server💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user ghl --env GHL_API_KEY=your-value --env GHL_LOCATION_ID=your-value -- npx -y @northrosetech/ghl-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "ghl": {
      "command": "npx",
      "args": [
        "-y",
        "@northrosetech/ghl-mcp-server"
      ],
      "env": {
        "GHL_API_KEY": "your-value",
        "GHL_LOCATION_ID": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ghl": {
      "command": "npx",
      "args": [
        "-y",
        "@northrosetech/ghl-mcp-server"
      ],
      "env": {
        "GHL_API_KEY": "your-value",
        "GHL_LOCATION_ID": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "ghl": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@northrosetech/ghl-mcp-server"
      ],
      "env": {
        "GHL_API_KEY": "your-value",
        "GHL_LOCATION_ID": "your-value"
      }
    }
  }
}

Valores que debes completar

  • GHL_API_KEY secreto obligatorio env
    GoHighLevel Private Integration Token. Create at: GHL Settings → Private Integrations → Create New Integration.
  • GHL_LOCATION_ID obligatorio env
    GoHighLevel sub-account (location) ID. Visible in the URL when viewing a sub-account.
  • GHL_BASE_URL env
    GHL API base URL. The default works for all standard installs.
  • GHL_API_VERSION env
    Value for the GHL API Version header.
  • TRANSPORT env
    Transport mode: 'stdio' for Claude Desktop / Claude Code, 'http' for N8N and remote clients.
  • LOG_LEVEL env
    Log verbosity.

Las descripciones siguen en el inglés original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
35/sem
Conexión
Se ejecuta en tu computadora
Última versióni
1.0.1
Publicado en el registroi
23 abr 2026
Último cambio de códigoi
23 abr 2026
Creador
northrosetech
Paquetes
npm: @northrosetech/ghl-mcp-server
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 14 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub northrosetech, dueña del repo

  • ! Precaución

    Sigue en mantenimiento

    Último cambio de código: hace 7 meses, hace más de 6 meses

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Marketing y redes socialesi

  • Más estrellas que el 85% de los otros 3929 servidores de esta categoría
  • Publicado en el registro más recientemente que el 5% de los otros 3929 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 55% de los otros 3929 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Ghl MCP Server?

Superó 2 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: GHL_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 7 meses, y la última versión (1.0.1) llegó al registro hace 7 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: PostHog MCP Server, Openshorts, Google Ads + Meta Ads + SEO/GEO MCP

Otros de la misma categoría

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

PostHog MCP Server

Official PostHog MCP Server for product analytics, feature flags, experiments, and more.

de PostHogMuy usado★ 40,8 mil Estrellas de todo el repositorioActualizado hace 10 meses

Se ejecuta en la nube

Openshorts

Turn long videos into viral vertical shorts and publish them to TikTok, Instagram and YouTube.

de mutonbyMuy usado★ 8,1 milActualizado hace 3 meses

Se ejecuta en la nube

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

GHL MCP Server

GoHighLevel MCP Server for Claude, N8N, and Custom AI Agents

Built by Saurabh K Shah (https://saurabhshah.com)

A comprehensive Model Context Protocol (MCP) server that connects AI assistants directly to your GoHighLevel CRM. Supports 60+ tools across contacts, conversations, calendars, pipelines, payments, invoices, workflows, custom fields, social media, and more.

Features

  • Contacts: Search, create, update, delete, upsert, tags, notes, tasks, workflow management
  • Conversations & Messaging: SMS, Email, WhatsApp, search threads, send messages, schedule sends
  • Calendars & Appointments: List calendars, get free slots, create/update/delete events
  • Opportunities & Pipelines: Full deal management, stage transitions, pipeline listing
  • Payments & Invoices: Orders, transactions, subscriptions, create/send/void invoices
  • Workflows: List all workflows, add/remove contacts from workflows
  • Custom Fields: List, create custom fields for contacts
  • Locations: Sub-account details, tags management
  • Users: Search team members
  • Forms & Surveys: List forms/surveys, get submissions
  • Campaigns: List all campaigns
  • Social Media: List/create posts, view connected accounts
  • Funnels & Blogs: List funnels, blogs
  • Products: List products and prices

Quick Start

1. Get Your GHL Credentials
  1. Log into GoHighLevel → Settings → Private Integrations
  2. Click Create New Integration
  3. Name it (e.g., "Claude MCP Server")
  4. Select all scopes you need (contacts, conversations, calendars, payments, etc.)
  5. Copy the Private Integration Token
  6. Note your Location ID (visible in the URL when viewing any sub-account)
2. Install & Configure
git clone https://github.com/northrosetech/ghl-mcp-server.git

cd ghl-mcp-server npm install cp .env.example .env

Edit .env:

GHL_API_KEY=your_private_integration_token_here

GHL_LOCATION_ID=your_location_id_here

Build:

npm run build
3. Connect to Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

{

"mcpServers": { "ghl": { "command": "node", "args": ["/absolute/path/to/ghl-mcp-server/dist/index.js"], "env": { "GHL_API_KEY": "your_private_integration_token", "GHL_LOCATION_ID": "your_location_id", "TRANSPORT": "stdio" } } } }

Restart Claude Desktop. You should see GHL tools available.

4. Connect to N8N (HTTP Mode)

Start the server in HTTP mode:

TRANSPORT=http PORT=3001 GHL_API_KEY=your_token GHL_LOCATION_ID=your_id node dist/index.js

In N8N:

  1. Add an MCP Client node
  2. Set URL to http://localhost:3001/mcp
  3. Set transport to HTTP Streamable
  4. Use the GHL tools in your workflows
5. Connect to Claude Code

Add to your project's .mcp.json:

{

"mcpServers": { "ghl": { "command": "node", "args": ["./ghl-mcp-server/dist/index.js"], "env": { "GHL_API_KEY": "your_token", "GHL_LOCATION_ID": "your_id" } } } }

Available Tools (60+)

Contacts (15 tools)
ToolDescription
ghl_search_contactsSearch contacts by query, tags, filters
ghl_get_contactGet contact by ID
ghl_create_contactCreate new contact
ghl_update_contactUpdate existing contact
ghl_delete_contactDelete contact
ghl_upsert_contactCreate or update by email/phone
ghl_add_contact_tagsAdd tags to contact
ghl_remove_contact_tagsRemove tags from contact
ghl_get_contact_notesGet contact notes
ghl_create_contact_noteAdd note to contact
ghl_delete_contact_noteDelete a note
ghl_get_contact_tasksGet contact tasks
ghl_create_contact_taskCreate task for contact
ghl_update_contact_taskUpdate task
ghl_add_contact_to_workflowAdd contact to workflow
ghl_remove_contact_from_workflowRemove from workflow
Conversations & Messaging (6 tools)
ToolDescription
ghl_search_conversationsSearch conversation threads
ghl_get_conversationGet conversation details
ghl_get_messagesGet messages in a thread
ghl_send_messageSend SMS/Email/WhatsApp/etc.
ghl_cancel_scheduled_messageCancel scheduled message
ghl_update_conversationUpdate conversation status
Calendars & Appointments (8 tools)
ToolDescription
ghl_list_calendarsList all calendars
ghl_get_calendarGet calendar details
ghl_get_free_slotsGet available booking slots
ghl_get_eventsGet appointments/events
ghl_create_eventCreate appointment
ghl_update_eventUpdate appointment
ghl_delete_eventDelete appointment
ghl_create_calendarCreate new calendar
Opportunities & Pipelines (7 tools)
ToolDescription
ghl_search_opportunitiesSearch deals
ghl_get_opportunityGet deal details
ghl_create_opportunityCreate new deal
ghl_update_opportunityUpdate deal / move stages
ghl_delete_opportunityDelete deal
ghl_update_opportunity_statusChange deal status
ghl_list_pipelinesList pipelines & stages
Payments & Invoices (9 tools)
ToolDescription
ghl_list_ordersList payment orders
ghl_get_orderGet order details
ghl_list_transactionsList transactions
ghl_list_subscriptionsList subscriptions
ghl_list_invoicesList invoices
ghl_get_invoiceGet invoice details
ghl_create_invoiceCreate invoice
ghl_send_invoiceEmail invoice to contact
ghl_void_invoiceVoid an invoice
Other Tools (15+ tools)
ToolDescription
ghl_list_workflowsList all workflows
ghl_list_custom_fieldsList custom fields
ghl_create_custom_fieldCreate custom field
ghl_get_locationGet location details
ghl_get_location_tagsGet location tags
ghl_create_location_tagCreate new tag
ghl_search_usersSearch team members
ghl_list_formsList forms
ghl_get_form_submissionsGet form submissions
ghl_list_surveysList surveys
ghl_list_campaignsList campaigns
ghl_list_social_postsList social posts
ghl_create_social_postCreate/schedule social post
ghl_list_social_accountsList connected social accounts
ghl_list_funnelsList funnels/websites
ghl_list_productsList products
ghl_list_blogsList blogs
ghl_list_linksList trigger links

Architecture

ghl-mcp-server/

├── src/ │ ├── index.ts # Entry point (stdio + HTTP transport) │ ├── constants.ts # All GHL API endpoints & config │ ├── types.ts # TypeScript interfaces │ ├── services/ │ │ └── api-client.ts # Auth, rate limiting, error handling │ └── tools/ │ ├── contacts.ts # Contact management tools │ ├── conversations.ts # Messaging tools │ ├── calendars.ts # Calendar & appointment tools │ ├── opportunities.ts # Pipeline & deal tools │ └── business.ts # Payments, invoices, workflows, etc. ├── dist/ # Compiled JS ├── package.json ├── tsconfig.json └── .env.example

Rate Limits

The server includes built-in rate limiting matching GHL's limits:

  • Burst: 100 requests per 10 seconds
  • Daily: 200,000 requests per day

The server automatically queues and retries when limits are approached.

Error Handling

All tools return actionable error messages with hints:

  • 401: Check your API key (must be Private Integration Token)
  • 403: Missing scopes — edit your Private Integration in GHL Settings
  • 404: Resource not found — check the ID
  • 422: Validation error with details
  • 429: Rate limit — automatic retry

License

MIT — Built by Saurabh K Shah (https://saurabhshah.com)