Skip to main content
Glama

GoHighLevel MCP Server

A Model Context Protocol server that gives an LLM agent operational control of a GoHighLevel CRM — 114 tools across 24 modules, covering contacts, pipelines, calendars, messaging, invoicing, and payments over the GoHighLevel API v2.

The problem

GoHighLevel is the system of record for a small agency: every client, every booking, every invoice. The work that actually eats the day is not any single CRM action but the stitching between them — a shoot gets confirmed, so someone has to create the opportunity, move it to the right pipeline stage, book the calendar slot against the right contact, draft the invoice, and log a note. Each step is thirty seconds of clicking, and the sequence runs several times a week.

That sequence is exactly what an agent can do, if it can reach the CRM. This server is that reach: it exposes GoHighLevel as typed, annotated tools so an agent can carry out the whole chain from a sentence of instruction, while the destructive and outward-facing steps stay visible for approval.

Related MCP server: MCP Suite CRM

Architecture

24 tool modules register against one McpServer over stdio. Everything routes through a single ghlRequest() that owns auth, the mandatory Version header, query-string assembly, and error shaping. Modules are toggleable at startup via GHL_DISABLED_MODULES — which matters more than it sounds, because 114 tool definitions is a meaningful chunk of an agent's context window before it has read a single word of the user's request. A deployment that only does bookings can register six modules and skip the rest.

  MCP host (Claude Desktop / Claude Code)
          | stdio (JSON-RPC)
  +-------v--------------------------------------------+
  |  index.ts   MODULES registry, GHL_DISABLED_MODULES  |
  +-------+--------------------------------------------+
          |
  +-------v-----+ +---------------+ +-----------+ ......  24 modules
  |  contacts   | | opportunities | | invoices  |
  +-------+-----+ +-------+-------+ +-----+-----+
          |               |               |
          |               |         +-----v--------------+
          |               |         | billing-helpers.ts |
          |               |         |  businessDetails   |
          |               |         |  contactDetails    |
          |               |         |  sender resolution |
          |               |         +-----+--------------+
          +-------+-------+---------------+
                  |
        +---------v----------------------------+
        |  client.ts  ghlRequest()             |
        |   Bearer token + Version header      |
        |   status-specific error hints        |
        +---------+----------------------------+
                  |
          services.leadconnectorhq.com

Every write tool carries MCP annotations — 17 are marked destructiveHint, and ghl_send_message / ghl_send_invoice are flagged as outward-facing because they contact real customers. The host surfaces those before approving a call, which is the difference between an agent that drafts an invoice and an agent that mails one to a client by accident.

The genuinely hard part

Creating an invoice. The endpoint takes businessDetails and contactDetails blocks, and the documentation understates both: pass a contactId and a couple of line items, as the docs suggest, and you get a validation error that names no field. Both blocks are required in full, and businessDetails.phoneNo and contactDetails.phoneNo are mandatory — a contact with an email and no phone cannot be invoiced at all.

Worse, the values have to match what the UI produces, or invoices created via the API look different from invoices created by hand — different logo, missing terms, wrong numbering. Those defaults are not in the location profile where you would expect them; they live behind GET /invoices/settings, which is the same source the UI pre-fills from.

src/tools/billing-helpers.ts resolves both blocks so the tools only need a contactId. Business details fall through four levels — per-call argument, GHL_BUSINESS_* env, saved invoice settings, location profile — with each level filling only what the one above left blank. Contact details are fetched and assembled, with name falling back through full name, first+last, company name, email, then phone, because GoHighLevel rejects an empty name and real CRM records are frequently missing one. Both paths throw a message naming the missing field and how to supply it, rather than surfacing GHL's opaque 422. Each lookup is memoised per location so a batch of ten invoices costs one settings fetch, not ten.

What I'd do differently

  1. No tests. 4,000 lines and none. The fallback chain in billing-helpers is pure logic over fixture data — the easiest thing in the repo to test and the most costly to get wrong, since the failure mode is a malformed invoice sent to a client.

  2. No retry on 429. ghlRequest tells the caller "rate limited; retry after a short delay" and then does not retry. Backoff belongs in the client, not in the agent's judgement.

  3. The caches are module-level mutable maps with no invalidation. Correct for a stdio server the host restarts freely; wrong the moment this runs as a long-lived process, where a business-profile edit would never be picked up.

  4. Responses are Record<string, unknown> throughout. GoHighLevel publishes an OpenAPI spec; generating types from it would turn a class of runtime surprises into compile errors.

  5. 114 tools in one server is too many. Module toggles are a workaround, not a fix. The better shape is a small set of tools plus a discovery mechanism, so the agent pays for what it uses.

Setup

Requires Node 20+ and a GoHighLevel account.

1. Create a Private Integration token

Settings → Private Integrations → Create new integration. Enable the scopes matching the tools you intend to use; at minimum:

contacts.readonly, contacts.write, opportunities.readonly, opportunities.write, calendars.readonly, calendars/events.write, conversations.readonly, conversations/message.write, invoices.readonly, invoices.write, products.readonly, products.write, locations/customFields.readonly, workflows.readonly

Copy the token — it starts with pit-.

2. Find your Location ID

Settings → Business Profile, or read it out of the dashboard URL: .../location/<LOCATION_ID>/...

3. Build

git clone <this-repo>
cd ghl-mcp
npm install
npm run build

4. Register with an MCP host

{
  "mcpServers": {
    "gohighlevel": {
      "command": "node",
      "args": ["/absolute/path/to/ghl-mcp/dist/index.js"],
      "env": {
        "GHL_API_KEY": "pit-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "GHL_LOCATION_ID": "your-location-id"
      }
    }
  }
}

Restart the host. See .env.example for every supported variable, including the invoice business block and the module toggles.

To exercise the server without a host:

GHL_API_KEY=pit-... GHL_LOCATION_ID=... npm run inspect

A note on "building automations"

GoHighLevel's API cannot create workflow logic — the visual builder is UI-only. The supported pattern is to build the workflow once in the UI, find its id with ghl_list_workflows, and enrol contacts with ghl_add_contact_to_workflow.

Tool reference

Area

Tools

Contacts

ghl_search_contacts, ghl_get_contact, ghl_create_contact, ghl_update_contact, ghl_add_contact_tags, ghl_delete_contact

Opportunities / Pipelines

ghl_get_pipelines, ghl_search_opportunities, ghl_get_opportunity, ghl_create_opportunity, ghl_update_opportunity

Calendars / Appointments

ghl_get_calendars, ghl_get_free_slots, ghl_create_appointment, ghl_get_appointment, ghl_update_appointment, ghl_delete_appointment

Conversations / Messaging

ghl_search_conversations, ghl_get_messages, ghl_send_message

Invoices

ghl_list_invoices, ghl_get_invoice, ghl_create_invoice, ghl_send_invoice, ghl_void_invoice, ghl_delete_invoice

Estimates

ghl_list_estimates, ghl_generate_estimate_number, ghl_create_estimate, ghl_update_estimate, ghl_send_estimate, ghl_estimate_to_invoice, ghl_delete_estimate

Products

ghl_list_products, ghl_get_product, ghl_create_product, ghl_update_product, ghl_delete_product, ghl_list_product_prices, ghl_create_product_price

Custom Fields

ghl_list_custom_fields, ghl_get_custom_field, ghl_create_custom_field, ghl_update_custom_field, ghl_delete_custom_field

Tasks

ghl_list_contact_tasks, ghl_get_contact_task, ghl_create_contact_task, ghl_update_contact_task, ghl_delete_contact_task

Notes

ghl_list_contact_notes, ghl_get_contact_note, ghl_create_contact_note, ghl_update_contact_note, ghl_delete_contact_note

Workflows (automations)

ghl_list_workflows, ghl_add_contact_to_workflow, ghl_remove_contact_from_workflow

Payments

ghl_list_orders, ghl_get_order, ghl_list_transactions, ghl_list_subscriptions, ghl_get_subscription

Forms & Surveys

ghl_list_forms, ghl_get_form_submissions, ghl_list_surveys, ghl_get_survey_submissions

Users & Teams

ghl_list_users, ghl_get_user

Calendar events

ghl_get_calendar_events, ghl_block_calendar_slot, ghl_list_appointment_notes, ghl_create_appointment_note

Social Planner

ghl_list_social_accounts, ghl_list_social_posts, ghl_get_social_post, ghl_create_social_post, ghl_delete_social_post

Media Library

ghl_list_media, ghl_upload_media_by_url, ghl_delete_media

Campaigns & Links

ghl_list_campaigns, ghl_add_contact_to_campaign, ghl_remove_contact_from_campaign, ghl_list_trigger_links, ghl_create_trigger_link, ghl_delete_trigger_link

Tags

ghl_list_tags, ghl_create_tag, ghl_update_tag, ghl_delete_tag

Custom Values

ghl_list_custom_values, ghl_get_custom_value, ghl_create_custom_value, ghl_update_custom_value, ghl_delete_custom_value

Businesses

ghl_list_businesses, ghl_get_business, ghl_create_business, ghl_update_business, ghl_delete_business

Custom Objects

ghl_list_object_schemas, ghl_get_object_schema, ghl_search_object_records, ghl_get_object_record, ghl_create_object_record, ghl_update_object_record, ghl_delete_object_record

Associations

ghl_list_associations, ghl_get_record_relations, ghl_create_relation, ghl_delete_relation

Funnels

ghl_list_funnels, ghl_list_funnel_pages

Licence

MIT — see LICENSE. Not affiliated with or endorsed by GoHighLevel.

Available Tools

114 tools
ghl_add_contact_tagsAdd contact tagsA
Idempotent

Add one or more tags to a contact without removing existing tags.

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

ghl_add_contact_to_campaignAdd contact to campaignA
Idempotent

Enroll a contact into a campaign, starting it for them.

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

ghl_add_contact_to_workflowAdd contact to workflowA
Idempotent

Enroll a contact into an automation workflow, triggering it for that contact. Use ghl_list_workflows to find workflowId.

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

ghl_block_calendar_slotBlock calendar slotA

Block off time on a calendar so it can't be booked (e.g. a filming or edit day). startTime/endTime are ISO 8601 strings.

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

ghl_create_appointmentBook appointmentA

Book an appointment on a calendar for a contact. startTime/endTime are ISO 8601 strings (e.g. 2026-06-20T15:00:00-04:00). Use ghl_get_free_slots first.

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

ghl_create_appointment_noteCreate appointment noteA

Add a note to a calendar appointment (e.g. outcome of a shoot/call).

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

ghl_create_businessCreate businessC

Create a business (company) record.

Inputs: name (required), city, email, phone, +6 more.

ghl_create_contactCreate contactA

Create a new contact. At least one of email or phone is recommended so the contact can be matched/deduplicated. Returns the created contact.

Inputs: name, tags, email, phone, +5 more.

ghl_create_contact_noteCreate contact noteA

Add a note to a contact.

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

ghl_create_contact_taskCreate contact taskA

Create a task on a contact. dueDate is ISO 8601 (e.g. 2026-06-20T17:00:00Z).

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

ghl_create_custom_fieldCreate custom fieldA

Create a custom field definition. For option-based types (SINGLE_OPTIONS, MULTIPLE_OPTIONS, RADIO, CHECKBOX) provide the options array.

Inputs: name (required), dataType (required), model, options, +3 more.

ghl_create_custom_valueCreate custom valueC

Create a new custom value (merge field) with a name and value.

Inputs: name (required), value (required), locationId.

ghl_create_estimateCreate estimateA

Create an estimate (quote) for a contact with line items. If your account requires it, get estimateNumber from ghl_generate_estimate_number first. issueDate/expiryDate are YYYY-MM-DD.

Inputs: name (required), items (required), contactId (required), title, +15 more.

ghl_create_invoiceCreate invoiceA

Create a draft invoice for a contact. Provide line items (name, qty, price). Business details are taken from GHL_BUSINESS_* env vars (or businessName/businessPhone overrides); contact details (name, phone, email, address) are auto-filled from the contact record. The invoice is created in draft status; use ghl_send_invoice to deliver it.

Inputs: name (required), items (required), contactId (required), title, +14 more.

ghl_create_object_recordCreate custom object recordB

Create a record for a custom object. properties is a key/value map matching the schema's property keys.

Inputs: schemaKey (required), properties (required), locationId.

ghl_create_opportunityCreate opportunityA

Create a new opportunity (deal) in a pipeline stage. Use ghl_get_pipelines first to obtain valid pipelineId and pipelineStageId values.

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

ghl_create_productCreate productA

Create a product. After creating, add one or more prices with ghl_create_product_price so it can be used on invoices/estimates.

Inputs: name (required), locationId, description, productType, +1 more.

ghl_create_product_priceCreate product priceA

Add a price to a product. type 'one_time' for a single charge or 'recurring' for a subscription. amount is in the smallest practical unit of the currency as accepted by GHL (typically major units, e.g. 49.99).

Inputs: name (required), amount (required), productId (required), type, +2 more.

ghl_create_relationCreate relationA

Create a relation between two records using an association definition. Get associationId from ghl_list_associations.

Inputs: associationId (required), firstRecordId (required), secondRecordId (required), locationId.

ghl_create_social_postCreate social postA

Schedule or publish a social post to one or more connected accounts. Provide scheduleDate (ISO 8601) for a scheduled post; omit for an immediate draft per status. mediaUrls can include image/video URLs already hosted in GHL.

Inputs: summary (required), accountIds (required), status, mediaUrls, +2 more.

ghl_create_tagCreate tagC

Create a new tag in the location's master tag list.

Inputs: name (required), locationId.

ghl_delete_appointmentDelete appointment / calendar eventA
DestructiveIdempotent

Delete a calendar event by its id. Works for both appointments and blocked time slots. Destructive and cannot be undone — to keep the record but mark it off, use ghl_update_appointment with appointmentStatus 'cancelled' instead.

Inputs: eventId (required).

ghl_delete_businessDelete businessB
DestructiveIdempotent

Delete a business record. Destructive.

Inputs: businessId (required).

ghl_delete_contactDelete contactA
DestructiveIdempotent

Permanently delete a contact. This is destructive and cannot be undone.

Inputs: contactId (required).

ghl_delete_contact_noteDelete contact noteA
DestructiveIdempotent

Delete a note from a contact. Destructive.

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

ghl_delete_contact_taskDelete contact taskA
DestructiveIdempotent

Delete a task from a contact. Destructive.

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

ghl_delete_custom_fieldDelete custom fieldA
DestructiveIdempotent

Delete a custom field definition. Destructive: removes the field and its stored values across records.

Inputs: customFieldId (required), locationId.

ghl_delete_custom_valueDelete custom valueC
DestructiveIdempotent

Delete a custom value. Destructive.

Inputs: customValueId (required), locationId.

ghl_delete_estimateDelete estimateC
DestructiveIdempotent

Delete an estimate. Destructive.

Inputs: estimateId (required), locationId.

ghl_delete_invoiceDelete invoiceA
DestructiveIdempotent

Delete an invoice. Only works while it is a draft — a sent invoice must be voided with ghl_void_invoice instead. Destructive and cannot be undone.

Inputs: invoiceId (required), locationId.

ghl_delete_mediaDelete media fileC
DestructiveIdempotent

Delete a file from the Media Library. Destructive.

Inputs: fileId (required), locationId.

ghl_delete_object_recordDelete custom object recordC
DestructiveIdempotent

Delete a custom object record. Destructive.

Inputs: recordId (required), schemaKey (required), locationId.

ghl_delete_productDelete productC
DestructiveIdempotent

Delete a product. Destructive.

Inputs: productId (required), locationId.

ghl_delete_relationDelete relationB
DestructiveIdempotent

Delete a relation between two records. Destructive.

Inputs: relationId (required), locationId.

ghl_delete_social_postDelete social postA
DestructiveIdempotent

Delete a scheduled or draft social post. Destructive.

Inputs: postId (required), locationId.

ghl_delete_tagDelete tagA
DestructiveIdempotent

Delete a tag from the location. Destructive: removes it from records.

Inputs: tagId (required), locationId.

ghl_estimate_to_invoiceConvert estimate to invoiceA

Create an invoice from an accepted estimate, carrying over its line items.

Inputs: estimateId (required), locationId.

ghl_generate_estimate_numberGenerate estimate numberA
Read-only

Generate the next available estimate number for the location. Some accounts require an estimateNumber when creating an estimate — call this first.

Inputs: locationId.

ghl_get_appointmentGet appointmentB
Read-only

Fetch a single calendar appointment/event by id.

Inputs: appointmentId (required).

ghl_get_businessGet businessA
Read-only

Fetch a single business record by id.

Inputs: businessId (required).

ghl_get_calendar_eventsGet calendar eventsA
Read-only

List calendar events/appointments within a time window. You must provide one of calendarId, userId, or groupId to scope the query. startTime/endTime are epoch milliseconds.

Inputs: endTime (required), startTime (required), userId, groupId, +2 more.

ghl_get_calendarsList calendarsA
Read-only

List calendars for a location. Use this to find a calendarId for booking and availability lookups.

Inputs: locationId.

ghl_get_contactGet contactA
Read-only

Fetch a single contact by id, including custom fields and tags.

Inputs: contactId (required).

ghl_get_contact_noteGet contact noteB
Read-only

Fetch a single note on a contact by id.

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

ghl_get_contact_taskGet contact taskB
Read-only

Fetch a single task on a contact by id.

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

ghl_get_custom_fieldGet custom fieldA
Read-only

Fetch a single custom field definition by id.

Inputs: customFieldId (required), locationId.

ghl_get_custom_valueGet custom valueC
Read-only

Fetch a single custom value by id.

Inputs: customValueId (required), locationId.

ghl_get_form_submissionsGet form submissionsA
Read-only

Fetch submissions for a location's forms, optionally filtered to one form or a date range. Dates are YYYY-MM-DD.

Inputs: page, endAt, limit, formId, +2 more.

ghl_get_free_slotsGet free appointment slotsA
Read-only

Get available booking slots for a calendar within a date range. startDate and endDate are epoch milliseconds.

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

ghl_get_invoiceGet invoiceA
Read-only

Fetch a single invoice by id, including line items and totals.

Inputs: invoiceId (required), locationId.

ghl_get_messagesGet conversation messagesA
Read-only

Fetch messages within a conversation thread, newest first. Use ghl_search_conversations to find a conversationId.

Inputs: conversationId (required), limit.

ghl_get_object_recordGet custom object recordB
Read-only

Fetch a single custom object record by id.

Inputs: recordId (required), schemaKey (required), locationId.

ghl_get_object_schemaGet custom object schemaB
Read-only

Fetch a custom object schema by key (e.g. custom_objects.podcast_episode), including its properties.

Inputs: schemaKey (required), locationId.

ghl_get_opportunityGet opportunityA
Read-only

Fetch a single opportunity (deal) by id.

Inputs: opportunityId (required).

ghl_get_orderGet orderA
Read-only

Fetch a single payment order by id, including line items and amounts.

Inputs: orderId (required), locationId.

ghl_get_pipelinesList pipelinesA
Read-only

List all opportunity pipelines and their stages for a location. Use this to discover pipelineId and pipelineStageId values needed by other tools.

Inputs: locationId.

ghl_get_productGet productB
Read-only

Fetch a single product by id.

Inputs: productId (required), locationId.

ghl_get_record_relationsGet record relationsB
Read-only

List the relations a given record participates in.

Inputs: recordId (required), skip, limit, locationId.

ghl_get_social_postGet social postA
Read-only

Fetch a single social post by id.

Inputs: postId (required), locationId.

ghl_get_subscriptionGet subscriptionC
Read-only

Fetch a single subscription by id.

Inputs: subscriptionId (required), locationId.

ghl_get_survey_submissionsGet survey submissionsA
Read-only

Fetch submissions for a location's surveys, optionally filtered to one survey.

Inputs: page, endAt, limit, startAt, +2 more.

ghl_get_userGet userB
Read-only

Fetch a single user by id.

Inputs: userId (required).

ghl_list_appointment_notesList appointment notesA
Read-only

List notes attached to a calendar appointment.

Inputs: appointmentId (required), limit, offset.

ghl_list_associationsList associationsA
Read-only

List association definitions in a location (the relationship types available between record kinds).

Inputs: skip, limit, locationId.

ghl_list_businessesList businessesA
Read-only

List business (company) records in a location.

Inputs: locationId.

ghl_list_campaignsList campaignsA
Read-only

List marketing campaigns in a location. Use a campaign id with ghl_add_contact_to_campaign.

Inputs: status, locationId.

ghl_list_contact_notesList contact notesA
Read-only

List all notes logged on a contact, newest first.

Inputs: contactId (required).

ghl_list_contact_tasksList contact tasksB
Read-only

List all tasks attached to a contact.

Inputs: contactId (required).

ghl_list_custom_fieldsList custom fieldsA
Read-only

List custom field definitions for a location. Filter by model (contact, opportunity, or all) to see which fields apply where. Use the returned ids when reading/writing custom field values on contacts.

Inputs: model, locationId.

ghl_list_custom_valuesList custom valuesA
Read-only

List location custom values (reusable merge fields used in templates/messages).

Inputs: locationId.

ghl_list_estimatesList estimatesA
Read-only

List estimates (quotes) for a location with pagination. Optionally filter by status or contact.

Inputs: limit, offset, status, contactId, +1 more.

ghl_list_formsList formsA
Read-only

List forms in a location. Use the returned form ids to fetch submissions.

Inputs: skip, limit, locationId.

ghl_list_funnel_pagesList funnel pagesC
Read-only

List the pages within a funnel.

Inputs: funnelId (required), name, limit, offset, +1 more.

ghl_list_funnelsList funnelsA
Read-only

List funnels in a location. Optionally filter by type, category, or name.

Inputs: name, type, limit, offset, +2 more.

ghl_list_invoicesList invoicesA
Read-only

List invoices for a location with pagination. Optionally filter by status (e.g. draft, sent, paid) and contact.

Inputs: limit, offset, status, contactId, +1 more.

ghl_list_mediaList media filesA
Read-only

List files/folders in the location's Media Library with pagination, search, and optional type filter.

Inputs: type, limit, query, offset, +3 more.

ghl_list_object_schemasList custom object schemasA
Read-only

List the custom object (and standard object) schemas defined in a location. Use the returned schema key with the record tools.

Inputs: locationId.

ghl_list_ordersList ordersA
Read-only

List payment orders for a location with pagination. Optionally filter by status or contact. Use to see what was purchased and whether it was paid.

Inputs: limit, offset, status, contactId, +1 more.

ghl_list_product_pricesList product pricesA
Read-only

List the prices configured for a product.

Inputs: productId (required), limit, offset, locationId.

ghl_list_productsList productsA
Read-only

List products in a location with pagination and optional search. Use the returned product ids when adding prices or building invoices/estimates.

Inputs: limit, offset, search, locationId.

ghl_list_social_accountsList social accountsA
Read-only

List the social media accounts connected to the location's Social Planner. Use the returned account ids when creating a post.

Inputs: locationId.

ghl_list_social_postsList social postsB
Read-only

List scheduled/published social posts for the location. Optionally filter by account ids and a date range (ISO 8601).

Inputs: skip, type, limit, toDate, +3 more.

ghl_list_subscriptionsList subscriptionsA
Read-only

List recurring subscriptions for a location (e.g. retainers). Optionally filter by contact.

Inputs: limit, offset, contactId, locationId.

ghl_list_surveysList surveysA
Read-only

List surveys in a location. Use the returned survey ids to fetch submissions.

Inputs: skip, limit, locationId.

ghl_list_tagsList tagsA
Read-only

List all tags defined in a location.

Inputs: locationId.

ghl_list_transactionsList transactionsA
Read-only

List payment transactions for a location. Useful for reconciling revenue and spotting failed or refunded charges.

Inputs: limit, offset, contactId, locationId.

ghl_list_usersList usersA
Read-only

List users (team members) in a location. Use the returned ids as assignedTo / assignedUserId values when creating tasks, opportunities, or appointments.

Inputs: locationId.

ghl_list_workflowsList workflowsA
Read-only

List the automation workflows configured in a location. Note: workflows must be built in the GoHighLevel UI; the API cannot create them. Use the returned workflow ids with ghl_add_contact_to_workflow to trigger automations.

Inputs: locationId.

ghl_remove_contact_from_campaignRemove contact from campaignA
Idempotent

Remove a contact from a campaign (or all campaigns if no id given).

Inputs: contactId (required), campaignId.

ghl_remove_contact_from_workflowRemove contact from workflowB
Idempotent

Remove a contact from an automation workflow, halting it for them.

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

ghl_search_contactsSearch contactsA
Read-only

Search/list contacts in a GoHighLevel location. Supports a free-text query (matches name, email, phone) and pagination. Returns matching contacts.

Inputs: limit, query, locationId, startAfter, +1 more.

ghl_search_conversationsSearch conversationsA
Read-only

Search conversations in a location, optionally filtered to a contact. Returns conversation threads with their ids and last-message info.

Inputs: limit, query, contactId, locationId.

ghl_search_object_recordsSearch custom object recordsC
Read-only

Search records of a custom object by a text query.

Inputs: schemaKey (required), skip, limit, query, +1 more.

ghl_search_opportunitiesSearch opportunitiesA
Read-only

Search opportunities (deals) in a location. Filter by pipeline, stage, status, assigned user, or free-text query.

Inputs: page, limit, query, status, +5 more.

ghl_send_estimateSend estimateA

Send an estimate to the contact. Outward-facing: this emails/texts the customer.

Inputs: estimateId (required), action, userId, liveMode, +1 more.

ghl_send_invoiceSend invoiceA

Send/deliver an existing invoice to the contact via the configured channel(s). This is outward-facing: it emails/texts the customer.

Inputs: invoiceId (required), action, userId, liveMode, +1 more.

ghl_send_messageSend messageA

Send an outbound message to a contact via SMS or Email. For Email you must provide subject and html (or message as plain text). For SMS provide message. The contact must have a valid phone/email for the chosen channel.

Inputs: type (required), contactId (required), html, message, +2 more.

ghl_update_appointmentUpdate appointmentA
Idempotent

Update an appointment's time or status (e.g. confirm, cancel, mark showed). Only provided fields are changed.

Inputs: appointmentId (required), title, endTime, startTime, +1 more.

ghl_update_businessUpdate businessA
Idempotent

Update a business record. Only provided fields change.

Inputs: businessId (required), city, name, email, +6 more.

ghl_update_contactUpdate contactA
Idempotent

Update fields on an existing contact. Only provided fields are changed.

Inputs: contactId (required), tags, email, phone, +3 more.

ghl_update_contact_noteUpdate contact noteB
Idempotent

Update the text of an existing note on a contact.

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

ghl_update_contact_taskUpdate contact taskB
Idempotent

Update a task (e.g. mark completed, change due date or assignee). Only provided fields change.

Inputs: taskId (required), contactId (required), body, title, +3 more.

ghl_update_custom_fieldUpdate custom fieldA
Idempotent

Update a custom field definition. Only provided fields change.

Inputs: customFieldId (required), name, options, position, +2 more.

ghl_update_custom_valueUpdate custom valueB
Idempotent

Update a custom value's name and/or value.

Inputs: name (required), value (required), customValueId (required), locationId.

ghl_update_estimateUpdate estimateA
Idempotent

Update an existing estimate. Pass the full set of items you want on the estimate (they replace the prior items). Only provided top-level fields change.

Inputs: estimateId (required), name, items, title, +4 more.

ghl_update_object_recordUpdate custom object recordC
Idempotent

Update a custom object record's properties.

Inputs: recordId (required), schemaKey (required), properties (required), locationId.

ghl_update_opportunityUpdate opportunityA
Idempotent

Update an opportunity: move stage, change status, value, name, or owner. Only provided fields are changed.

Inputs: opportunityId (required), name, status, assignedTo, +3 more.

ghl_update_productUpdate productA
Idempotent

Update a product's fields. Only provided fields change.

Inputs: productId (required), name, locationId, description, +2 more.

ghl_update_tagUpdate tagC
Idempotent

Rename an existing tag.

Inputs: name (required), tagId (required), locationId.

ghl_upload_media_by_urlUpload media by URLA

Add a file to the Media Library by referencing a publicly reachable URL (GHL fetches and hosts it). Good for deliverables or talent photos already available at a link. For raw binary uploads use the GHL UI.

Inputs: fileUrl (required), name, locationId.

ghl_void_invoiceVoid invoiceA
DestructiveIdempotent

Void an invoice. Use this for invoices that have already been sent (which can no longer be deleted). Voiding cancels the invoice while keeping the record.

Inputs: invoiceId (required), locationId.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 114 tools

    Disambiguation4/5

    Tool names consistently include the target resource (contact, opportunity, invoice, task, note, etc.), so most actions are clearly distinct even with 114 tools. A few near-neighbor pairs—custom_field vs custom_value, contact_note vs appointment_note, and association vs relation—could require careful description reading, but they are not genuinely interchangeable.

    Naming Consistency4/5

    The dominant ghl_<verb>_<noun> pattern is clear and mostly followed. However, several plural list operations use get_ instead of list_ (ghl_get_calendars, ghl_get_pipelines, ghl_get_messages, ghl_get_form_submissions), and ghl_estimate_to_invoice breaks the verb_noun pattern.

    Tool Count1/5

    114 tools is an extreme count for an agent-facing MCP server; even though GoHighLevel covers many domains, this surface is far beyond the 3-15 tool range considered well-scoped. The sheer number will overwhelm tool selection and context windows regardless of how individually useful the tools are.

    Completeness3/5

    The server covers a very wide range of GHL resources with strong CRUD coverage for contacts, tasks, notes, products, tags, custom values, and businesses. Notable gaps exist, though: there is no ghl_get_estimate (making estimate updates awkward), no ghl_update_invoice, and no delete for opportunities, leaving some lifecycle dead ends.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to perform CRM operations like creating contacts, managing deals, and updating leads through natural language using the Model Context Protocol.
      4
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to interact with a CRM covering companies, people, leads, deals, and more, with role checks, scoped agent keys, approval gates, and a shared audit trail.
      AGPL 3.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP-native CRM backend for AI agents, enabling customer, opportunity, note, follow-up, and pipeline health management through 15 MCP tools.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Exposes the entire CRM as rows in Postgres via 73 MCP tools, letting AI agents create, read, update, and manage tables, documents, dashboards, chat, calendar, agent memory, web research, and images through the same operations as the UI.
      MIT