Skip to main content
Glama

GoHighLevel MCP Server

ghl-mcp is a Model Context Protocol server for GoHighLevel API v2. It exposes contacts, opportunities, conversations, calendars, workflows, users, invoices, payments, social, forms, funnels, tasks, products, emails, campaigns, and documents as MCP tools over stdio so Claude Code, Cursor, Codex, OpenClaw, VS Code, and other MCP clients can work directly with GoHighLevel CRM data.

Features

  • 50 MCP tools covering high-value GoHighLevel CRM, billing, marketing, and operations workflows

  • Built on @modelcontextprotocol/sdk v1.x

  • Strict TypeScript configuration

  • Zod-validated tool inputs with descriptions on every field

  • Automatic locationId injection from environment variables

  • Basic request pacing to stay under GoHighLevel rate limits

  • Human-readable tool error payloads instead of raw stack traces

Related MCP server: CashClaw GHL MCP

Requirements

  • Node.js 18+

  • A GoHighLevel API token

  • A GoHighLevel location ID

Installation

Local development

npm install
npm run build
node dist/index.js

Run with npx

npx -y ghl-mcp

Configuration

Set these environment variables in the MCP client configuration:

  • GHL_API_TOKEN: Private Integration token or OAuth access token

  • GHL_LOCATION_ID: GoHighLevel location or sub-account ID

The server sends these headers on every request:

Authorization: Bearer {GHL_API_TOKEN}
Content-Type: application/json
Version: 2021-07-28

MCP Client Setup

Claude Code

Note: claude mcp add registers a local server name — it doesn't download from a registry. The part after -- is the actual command that runs the server.

# After npm publish (recommended):
claude mcp add gohighlevel --scope user \
  --env GHL_API_TOKEN="your-token" \
  --env GHL_LOCATION_ID="your-location-id" \
  -- npx -y ghl-mcp

# Local development (before publishing):
claude mcp add gohighlevel --scope user \
  --env GHL_API_TOKEN="your-token" \
  --env GHL_LOCATION_ID="your-location-id" \
  -- node /absolute/path/to/ghl-mcp/dist/index.js

Cursor / VS Code / Codex style config

{
  "mcpServers": {
    "gohighlevel": {
      "command": "npx",
      "args": ["-y", "ghl-mcp"],
      "env": {
        "GHL_API_TOKEN": "your-token-here",
        "GHL_LOCATION_ID": "your-location-id"
      }
    }
  }
}

MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

Tool List

Contacts

  • search_contacts: Search contacts by text, tag, pagination, or advanced filters

  • get_contact: Retrieve one contact by ID

  • create_contact: Create a contact

  • update_contact: Update contact fields

  • delete_contact: Delete a contact

  • add_contact_tags: Add tags to a contact

  • remove_contact_tags: Remove tags from a contact

  • get_contact_notes: List notes for a contact

  • create_contact_note: Create a note on a contact

Opportunities

  • search_opportunities: Search deals by query, pipeline, stage, status, contact, or owner

  • get_opportunity: Retrieve one opportunity by ID

  • create_opportunity: Create an opportunity

  • update_opportunity: Update opportunity fields

  • delete_opportunity: Delete an opportunity

  • update_opportunity_status: Change status to open, won, lost, or abandoned

  • list_pipelines: List pipelines and fetch their stages

Conversations

  • search_conversations: Search conversations

  • get_conversation: Retrieve one conversation by ID

  • get_conversation_messages: List messages in a conversation

  • send_message: Send SMS, email, WhatsApp, or similar messages

  • create_conversation: Start a new conversation

Calendars

  • list_calendars: List calendars

  • list_events: List events or appointments

  • create_event: Create an event

  • get_available_slots: Retrieve available booking slots

Workflows

  • list_workflows: List workflows

  • trigger_workflow: Trigger a workflow for a contact

Users

  • list_users: List users in the configured location

  • get_user: Retrieve one user by ID

Invoices And Payments

  • list_invoices: List invoices

  • create_invoice: Create an invoice

  • list_transactions: List payment transactions

  • list_orders: List payment orders

  • list_subscriptions: List subscriptions

Social

  • list_social_posts: List social posts

  • create_social_post: Create or schedule a social post

  • list_social_accounts: List connected social accounts

  • get_social_stats: Retrieve social statistics

Forms And Funnels

  • list_forms: List forms

  • list_funnels: List funnels

  • list_funnel_pages: List funnel pages

Tasks

  • list_tasks: List tasks for a contact

  • create_task: Create a task for a contact

Products

  • list_products: List products

  • list_product_prices: List prices for a product

Emails

  • list_email_templates: List email templates

  • list_email_schedules: List scheduled emails

Campaigns

  • list_campaigns: List campaigns

Documents

  • list_contracts: List contracts or documents

  • send_contract_link: Send a contract link for signing

Development

npm run dev

Build output goes to dist/.

Architecture

src/
├── index.ts
├── client.ts
├── types.ts
└── tools/
    ├── calendars.ts
    ├── campaigns.ts
    ├── contacts.ts
    ├── conversations.ts
    ├── documents.ts
    ├── emails.ts
    ├── forms.ts
    ├── invoices.ts
    ├── opportunities.ts
    ├── products.ts
    ├── social.ts
    ├── tasks.ts
    ├── users.ts
    └── workflows.ts

Implementation Notes

  • Most endpoints require locationId. This server injects it automatically into request query strings and JSON bodies unless a value is already provided.

  • The client applies a minimum delay between requests to reduce the chance of hitting GoHighLevel's rate limits.

  • Tool responses are returned as JSON text blocks with a short summary and the raw API payload.

  • Pipeline listing fetches pipeline stage details for each returned pipeline so agents get usable stage metadata in one call.

Example Workflows

Find a contact and add a note

  1. Call search_contacts with query: "jane@company.com"

  2. Call get_contact with the selected contactId

  3. Call create_contact_note with the contactId and note text

Create and advance an opportunity

  1. Call list_pipelines to find the target pipeline and stage IDs

  2. Call create_opportunity with contactId, pipelineId, pipelineStageId, and name

  3. Call update_opportunity or update_opportunity_status as the deal progresses

Book an appointment

  1. Call get_available_slots with a calendarId and date range

  2. Call create_event with the selected time slot and optional contactId

Publishing

npm publish --access public

The published package installs the ghl-mcp binary from dist/index.js.

Available Tools

50 tools
add_contact_tagsC

Add one or more tags to a GoHighLevel contact.

Inputs: contactId (required), tags (required).

create_contactB

Create a new GoHighLevel contact.

Inputs: firstName, lastName, name, email, +7 more.

create_contact_noteB

Create a note on a GoHighLevel contact.

Inputs: contactId (required), body (required), userId.

create_conversationC

Start a new GoHighLevel conversation.

Inputs: contactId (required), channel (required), message, assignedTo.

create_eventB

Create a GoHighLevel appointment or calendar event.

Inputs: calendarId (required), title (required), startTime (required), endTime (required), +4 more.

create_invoiceB

Create a GoHighLevel invoice.

Inputs: contactId (required), title (required), amount, currency, +5 more.

create_opportunityC

Create a new GoHighLevel opportunity.

Inputs: contactId (required), pipelineId (required), pipelineStageId (required), name (required), +4 more.

create_social_postB

Create or schedule a GoHighLevel social post.

Inputs: accountIds (required), text (required), scheduledAt, mediaUrls, +1 more.

create_taskC

Create a GoHighLevel task for a contact.

Inputs: contactId (required), title (required), dueDate (required), body, +2 more.

delete_contactB

Delete a GoHighLevel contact.

Inputs: contactId (required).

delete_opportunityB

Delete a GoHighLevel opportunity.

Inputs: opportunityId (required).

get_available_slotsC

Get available GoHighLevel booking slots for a calendar.

Inputs: calendarId (required), startDate (required), endDate (required), timezone.

get_contactA

Get a single GoHighLevel contact with full details.

Inputs: contactId (required).

get_contact_notesB

List notes attached to a GoHighLevel contact.

Inputs: contactId (required).

get_conversationB

Get a single GoHighLevel conversation by ID.

Inputs: conversationId (required).

get_conversation_messagesB

List messages in a GoHighLevel conversation.

Inputs: conversationId (required), limit.

get_opportunityB

Get a single GoHighLevel opportunity by ID.

Inputs: opportunityId (required).

get_social_statsC

Get GoHighLevel social account or post statistics.

Inputs: accountId, startDate, endDate, platform.

get_userA

Get a single GoHighLevel user by ID.

Inputs: userId (required).

list_calendarsB

List GoHighLevel calendars for the configured location.

Inputs: groupId.

list_campaignsC

List GoHighLevel campaigns for the configured location.

Inputs: status, search.

list_contractsC

List GoHighLevel contracts or documents.

Inputs: contactId, status, altId.

list_email_schedulesB

List GoHighLevel scheduled emails.

Inputs: campaignId, status.

list_email_templatesB

List GoHighLevel email builder templates.

Inputs: campaignId, folderId, search.

list_eventsC

List GoHighLevel calendar events or appointments.

Inputs: calendarId, startTime, endTime.

list_formsB

List GoHighLevel forms for the configured location.

Inputs: name.

list_funnel_pagesC

List GoHighLevel funnel pages.

Inputs: funnelId, name.

list_funnelsB

List GoHighLevel funnels for the configured location.

Inputs: name.

list_invoicesC

List GoHighLevel invoices for the configured location.

Inputs: status, contactId, altId.

list_ordersC

List GoHighLevel payment orders.

Inputs: contactId, status, altId.

list_pipelinesA

List GoHighLevel pipelines and include their stages.

Inputs: no named parameters.

list_product_pricesB

List GoHighLevel prices for a product.

Inputs: productId (required), currency.

list_productsB

List GoHighLevel products for the configured location.

Inputs: altId, search.

list_social_accountsB

List connected GoHighLevel social accounts.

Inputs: platform.

list_social_postsC

List GoHighLevel social posts for the configured location.

Inputs: accountId, status, startDate, endDate.

list_subscriptionsC

List GoHighLevel subscriptions.

Inputs: contactId, status, altId.

list_tasksA

List GoHighLevel tasks for a contact.

Inputs: contactId (required), status.

list_transactionsC

List GoHighLevel payment transactions.

Inputs: contactId, subscriptionId, orderId, altId.

list_usersB

List users or team members in the configured GoHighLevel location.

Inputs: role.

list_workflowsC

List GoHighLevel workflows available in the configured location.

Inputs: status.

remove_contact_tagsC

Remove one or more tags from a GoHighLevel contact.

Inputs: contactId (required), tags (required).

search_contactsA

Search for GoHighLevel contacts by name, email, phone, tag, or advanced filters.

Inputs: query, tag, limit, startAfterId, +2 more.

search_conversationsC

Search GoHighLevel conversations.

Inputs: query, contactId, assignedTo, status, +1 more.

search_opportunitiesC

Search GoHighLevel opportunities in a pipeline.

Inputs: query, pipelineId, pipelineStageId, status, +2 more.

send_messageC

Send an SMS, email, or other GoHighLevel conversation message.

Inputs: type (required), message (required), contactId, conversationId, +4 more.

trigger_workflowB

Trigger a GoHighLevel workflow for a contact.

Inputs: workflowId (required), contactId (required), eventData.

update_contactB

Update fields on an existing GoHighLevel contact.

Inputs: contactId (required), firstName, lastName, name, +8 more.

update_opportunityC

Update an existing GoHighLevel opportunity.

Inputs: opportunityId (required), contactId, pipelineId, pipelineStageId, +5 more.

update_opportunity_statusB

Change the status of a GoHighLevel opportunity.

Inputs: opportunityId (required), status (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 50 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action, with clear names and descriptions. There is no ambiguity between tools like list_contacts and search_contacts or between various CRUD operations for different entities.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using lowercase and underscores. Verbs like create, get, list, update, delete, search are used uniformly across the set.

    Tool Count2/5

    With 50 tools, the set is overly large, containing many list_* tools that could be consolidated or reduced. The number exceeds the recommended upper bound for a well-scoped server, making it harder for agents to navigate.

    Completeness3/5

    The tool set covers core CRUD for contacts and opportunities, but lacks CRUD completeness for other entities like invoices (only create and list, no get/update/delete) and conversations (no delete). Some notable gaps exist.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A comprehensive MCP server that connects AI assistants to GoHighLevel CRM, enabling management of contacts, conversations, calendars, pipelines, payments, and more through 60+ tools.
      64
      37 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for GoHighLevel with 82 live-tested tools, enabling CRM operations like contact management, appointments, invoices, and workflows via natural language.
      Creative Commons Attribution Non Commercial 4.0 International
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for GoHighLevel sub-accounts, enabling management of CRM contacts, pipelines, calendars, invoices, and more via natural language.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      A comprehensive MCP server that connects AI systems to GoHighLevel CRM, providing 269+ tools for contact management, messaging, calendar, sales, and automation.
      10 npm
      MIT