GoHighLevel MCP Server
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., "@GoHighLevel MCP Server Book a calendar slot for the new lead and draft an invoice"
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.
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.comEvery 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
No tests. 4,000 lines and none. The fallback chain in
billing-helpersis 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.No retry on 429.
ghlRequesttells 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.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.
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.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 build4. 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 inspectA 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 |
|
Opportunities / Pipelines |
|
Calendars / Appointments |
|
Conversations / Messaging |
|
Invoices |
|
Estimates |
|
Products |
|
Custom Fields |
|
Tasks |
|
Notes |
|
Workflows (automations) |
|
Payments |
|
Forms & Surveys |
|
Users & Teams |
|
Calendar events |
|
Social Planner |
|
Media Library |
|
Campaigns & Links |
|
Tags |
|
Custom Values |
|
Businesses |
|
Custom Objects |
|
Associations |
|
Funnels |
|
Licence
MIT — see LICENSE. Not affiliated with or endorsed by GoHighLevel.
Available Tools
114 toolsghl_add_contact_tagsAdd contact tagsAIdempotent
Add one or more tags to a contact without removing existing tags.
Inputs: tags (required), contactId (required).
ghl_add_contact_to_campaignAdd contact to campaignAIdempotent
Enroll a contact into a campaign, starting it for them.
Inputs: contactId (required), campaignId (required).
ghl_add_contact_to_workflowAdd contact to workflowAIdempotent
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_create_trigger_linkCreate trigger linkA
Create a trackable trigger link that redirects to a destination URL and can fire automations on click.
Inputs: name (required), redirectTo (required), locationId.
ghl_delete_appointmentDelete appointment / calendar eventADestructiveIdempotent
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 businessBDestructiveIdempotent
Delete a business record. Destructive.
Inputs: businessId (required).
ghl_delete_contactDelete contactADestructiveIdempotent
Permanently delete a contact. This is destructive and cannot be undone.
Inputs: contactId (required).
ghl_delete_contact_noteDelete contact noteADestructiveIdempotent
Delete a note from a contact. Destructive.
Inputs: noteId (required), contactId (required).
ghl_delete_contact_taskDelete contact taskADestructiveIdempotent
Delete a task from a contact. Destructive.
Inputs: taskId (required), contactId (required).
ghl_delete_custom_fieldDelete custom fieldADestructiveIdempotent
Delete a custom field definition. Destructive: removes the field and its stored values across records.
Inputs: customFieldId (required), locationId.
ghl_delete_custom_valueDelete custom valueCDestructiveIdempotent
Delete a custom value. Destructive.
Inputs: customValueId (required), locationId.
ghl_delete_estimateDelete estimateCDestructiveIdempotent
Delete an estimate. Destructive.
Inputs: estimateId (required), locationId.
ghl_delete_invoiceDelete invoiceADestructiveIdempotent
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 fileCDestructiveIdempotent
Delete a file from the Media Library. Destructive.
Inputs: fileId (required), locationId.
ghl_delete_object_recordDelete custom object recordCDestructiveIdempotent
Delete a custom object record. Destructive.
Inputs: recordId (required), schemaKey (required), locationId.
ghl_delete_productDelete productCDestructiveIdempotent
Delete a product. Destructive.
Inputs: productId (required), locationId.
ghl_delete_relationDelete relationBDestructiveIdempotent
Delete a relation between two records. Destructive.
Inputs: relationId (required), locationId.
ghl_delete_social_postDelete social postADestructiveIdempotent
Delete a scheduled or draft social post. Destructive.
Inputs: postId (required), locationId.
ghl_delete_tagDelete tagADestructiveIdempotent
Delete a tag from the location. Destructive: removes it from records.
Inputs: tagId (required), locationId.
ghl_delete_trigger_linkDelete trigger linkBDestructiveIdempotent
Delete a trigger link. Destructive.
Inputs: linkId (required).
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 numberARead-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 appointmentBRead-only
Fetch a single calendar appointment/event by id.
Inputs: appointmentId (required).
ghl_get_businessGet businessARead-only
Fetch a single business record by id.
Inputs: businessId (required).
ghl_get_calendar_eventsGet calendar eventsARead-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 calendarsARead-only
List calendars for a location. Use this to find a calendarId for booking and availability lookups.
Inputs: locationId.
ghl_get_contactGet contactARead-only
Fetch a single contact by id, including custom fields and tags.
Inputs: contactId (required).
ghl_get_contact_noteGet contact noteBRead-only
Fetch a single note on a contact by id.
Inputs: noteId (required), contactId (required).
ghl_get_contact_taskGet contact taskBRead-only
Fetch a single task on a contact by id.
Inputs: taskId (required), contactId (required).
ghl_get_custom_fieldGet custom fieldARead-only
Fetch a single custom field definition by id.
Inputs: customFieldId (required), locationId.
ghl_get_custom_valueGet custom valueCRead-only
Fetch a single custom value by id.
Inputs: customValueId (required), locationId.
ghl_get_form_submissionsGet form submissionsARead-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 slotsARead-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 invoiceARead-only
Fetch a single invoice by id, including line items and totals.
Inputs: invoiceId (required), locationId.
ghl_get_messagesGet conversation messagesARead-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 recordBRead-only
Fetch a single custom object record by id.
Inputs: recordId (required), schemaKey (required), locationId.
ghl_get_object_schemaGet custom object schemaBRead-only
Fetch a custom object schema by key (e.g. custom_objects.podcast_episode), including its properties.
Inputs: schemaKey (required), locationId.
ghl_get_opportunityGet opportunityARead-only
Fetch a single opportunity (deal) by id.
Inputs: opportunityId (required).
ghl_get_orderGet orderARead-only
Fetch a single payment order by id, including line items and amounts.
Inputs: orderId (required), locationId.
ghl_get_pipelinesList pipelinesARead-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 productBRead-only
Fetch a single product by id.
Inputs: productId (required), locationId.
ghl_get_record_relationsGet record relationsBRead-only
List the relations a given record participates in.
Inputs: recordId (required), skip, limit, locationId.
ghl_get_social_postGet social postARead-only
Fetch a single social post by id.
Inputs: postId (required), locationId.
ghl_get_subscriptionGet subscriptionCRead-only
Fetch a single subscription by id.
Inputs: subscriptionId (required), locationId.
ghl_get_survey_submissionsGet survey submissionsARead-only
Fetch submissions for a location's surveys, optionally filtered to one survey.
Inputs: page, endAt, limit, startAt, +2 more.
ghl_get_userGet userBRead-only
Fetch a single user by id.
Inputs: userId (required).
ghl_list_appointment_notesList appointment notesARead-only
List notes attached to a calendar appointment.
Inputs: appointmentId (required), limit, offset.
ghl_list_associationsList associationsARead-only
List association definitions in a location (the relationship types available between record kinds).
Inputs: skip, limit, locationId.
ghl_list_businessesList businessesARead-only
List business (company) records in a location.
Inputs: locationId.
ghl_list_campaignsList campaignsARead-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 notesARead-only
List all notes logged on a contact, newest first.
Inputs: contactId (required).
ghl_list_contact_tasksList contact tasksBRead-only
List all tasks attached to a contact.
Inputs: contactId (required).
ghl_list_custom_fieldsList custom fieldsARead-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 valuesARead-only
List location custom values (reusable merge fields used in templates/messages).
Inputs: locationId.
ghl_list_estimatesList estimatesARead-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 formsARead-only
List forms in a location. Use the returned form ids to fetch submissions.
Inputs: skip, limit, locationId.
ghl_list_funnel_pagesList funnel pagesCRead-only
List the pages within a funnel.
Inputs: funnelId (required), name, limit, offset, +1 more.
ghl_list_funnelsList funnelsARead-only
List funnels in a location. Optionally filter by type, category, or name.
Inputs: name, type, limit, offset, +2 more.
ghl_list_invoicesList invoicesARead-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 filesARead-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 schemasARead-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 ordersARead-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 pricesARead-only
List the prices configured for a product.
Inputs: productId (required), limit, offset, locationId.
ghl_list_productsList productsARead-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 accountsARead-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 postsBRead-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 subscriptionsARead-only
List recurring subscriptions for a location (e.g. retainers). Optionally filter by contact.
Inputs: limit, offset, contactId, locationId.
ghl_list_surveysList surveysARead-only
List surveys in a location. Use the returned survey ids to fetch submissions.
Inputs: skip, limit, locationId.
ghl_list_tagsList tagsARead-only
List all tags defined in a location.
Inputs: locationId.
ghl_list_transactionsList transactionsARead-only
List payment transactions for a location. Useful for reconciling revenue and spotting failed or refunded charges.
Inputs: limit, offset, contactId, locationId.
ghl_list_trigger_linksList trigger linksARead-only
List trackable trigger links in a location.
Inputs: locationId.
ghl_list_usersList usersARead-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 workflowsARead-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 campaignAIdempotent
Remove a contact from a campaign (or all campaigns if no id given).
Inputs: contactId (required), campaignId.
ghl_remove_contact_from_workflowRemove contact from workflowBIdempotent
Remove a contact from an automation workflow, halting it for them.
Inputs: contactId (required), workflowId (required).
ghl_search_contactsSearch contactsARead-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 conversationsARead-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 recordsCRead-only
Search records of a custom object by a text query.
Inputs: schemaKey (required), skip, limit, query, +1 more.
ghl_search_opportunitiesSearch opportunitiesARead-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 appointmentAIdempotent
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 businessAIdempotent
Update a business record. Only provided fields change.
Inputs: businessId (required), city, name, email, +6 more.
ghl_update_contactUpdate contactAIdempotent
Update fields on an existing contact. Only provided fields are changed.
Inputs: contactId (required), tags, email, phone, +3 more.
ghl_update_contact_noteUpdate contact noteBIdempotent
Update the text of an existing note on a contact.
Inputs: body (required), noteId (required), contactId (required), userId.
ghl_update_contact_taskUpdate contact taskBIdempotent
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 fieldAIdempotent
Update a custom field definition. Only provided fields change.
Inputs: customFieldId (required), name, options, position, +2 more.
ghl_update_custom_valueUpdate custom valueBIdempotent
Update a custom value's name and/or value.
Inputs: name (required), value (required), customValueId (required), locationId.
ghl_update_estimateUpdate estimateAIdempotent
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 recordCIdempotent
Update a custom object record's properties.
Inputs: recordId (required), schemaKey (required), properties (required), locationId.
ghl_update_opportunityUpdate opportunityAIdempotent
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 productAIdempotent
Update a product's fields. Only provided fields change.
Inputs: productId (required), name, locationId, description, +2 more.
ghl_update_tagUpdate tagCIdempotent
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 invoiceADestructiveIdempotent
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
Scored across 114 tools
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.
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.
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.
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
Agent-native CRM. 25 tools — contacts, deals, sequences, enrichment waterfall, audit log.
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
CRM, inbox, meetings, revenue intelligence, analytics and automations for AI agents.
Open-source CRM for AI agents: humans, orgs, interactions, deals, tasks, links and an activity log.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to perform CRM operations like creating contacts, managing deals, and updating leads through natural language using the Model Context Protocol.4-
- AlicenseNot gradedqualityBmaintenanceEnables 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
- FlicenseNot gradedqualityDmaintenanceAn MCP-native CRM backend for AI agents, enabling customer, opportunity, note, follow-up, and pipeline health management through 15 MCP tools.-
- AlicenseNot gradedqualityCmaintenanceExposes 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