GoHighLevel MCP

Use GHL tools through the MAD MCP broker for contact ops, pipeline management, messaging, and scheduling workflows.

Authentication

• Header: Authorization

• Format: Bearer mad_live_***

• Broker credentials are generated in the MCP Portal Configurations tab.

• GHL sub-account PIT + location credentials are configured in Integrations.

Catalog Coverage

• Total tools: 272
• GET tools: 80
• POST tools: 192
• Snapshot version: snapshot-20260330T033151Z
• Snapshot captured at: 2026-03-30T03:31:51.722Z
• Docs generated at: 2026-03-30T04:36:10.795Z

GET Tools

• Find Contact By Email All Tenants — Find contacts by email across all tenants.
• Find Location By Name All Tenants — Find locations by name/domain/email across all tenants.
• Find Pipeline By Name All Tenants — Find pipelines by name across all tenants.
• Get All Location Tasks — Get all tasks for a location with auto-pagination and optional QA filtering.
• Get All Objects — Get all objects (custom and standard) for a location including contact, opportunity, business, and custom objects
• Get Appointment — Get detailed information about a specific appointment by ID
• Get Appointment Notes — Get notes for an appointment
• Get Blocked Slots — Get blocked time slots for a location
• Get Blog Authors — Get all available blog authors for the current location. Use this to find author IDs for creating blog posts.
• Get Blog Categories — Get all available blog categories for the current location. Use this to find category IDs for creating blog posts.
• Get Blog Posts — Get blog posts from a specific blog site. Use this to list and search existing blog posts.
• Get Blog Sites — Get all blog sites for the current location. Use this to find available blogs before creating or managing posts.
• Get Calendar — Get detailed information about a specific calendar by ID
• Get Calendar Events — Get appointments/events from calendars within a date range
• Get Calendar Groups — Get all calendar groups in the GoHighLevel location
• Get Calendar Notification — Get specific calendar notification
• Get Calendar Notifications — Get calendar notifications
• Get Calendar Resource Equipment — Get specific equipment resource details
• Get Calendar Resource Room — Get specific room resource details
• Get Calendar Resources Equipments — Get calendar equipment resources
• Get Calendar Resources Rooms — Get calendar room resources
• Get Calendars — Get all calendars in the GoHighLevel location with optional filtering
• Get Contact — Get detailed information about a specific contact
• Get Contact Appointments — Get all appointments for a contact
• Get Contact Note — Get a specific note for a contact
• Get Contact Notes — Get all notes for a contact
• Get Contact Task — Get a specific task for a contact
• Get Contact Tasks — Get all tasks for a contact
• Get Contacts By Business — Get contacts associated with a specific business
• Get Conversation — Get detailed conversation information including message history
• Get Csv Upload Status — Get status of CSV uploads
• Get Duplicate Contact — Check for duplicate contacts by email or phone
• Get Email Campaigns — Get a list of email campaigns from GoHighLevel.
• Get Email Message — Get detailed email message information by email message ID
• Get Email Templates — Get a list of email templates from GoHighLevel.
• Get Free Slots — Get available time slots for booking appointments on a specific calendar
• Get Location — Get detailed information about a specific location/sub-account by ID
• Get Location Custom Field — Get a specific custom field by ID
• Get Location Custom Fields — Get custom fields for a location, optionally filtered by model type
• Get Location Custom Value — Get a specific custom value by ID
• Get Location Custom Values — Get all custom values for a location
• Get Location Tag — Get a specific location tag by ID
• Get Location Tags — Get all tags for a specific location
• Get Location Templates — Get SMS/Email templates for a location
• Get Media Files — Get list of files and folders from the media library with filtering and search capabilities
• Get Message — Get detailed message information by message ID
• Get Message Recording — Get call recording audio for a message
• Get Message Transcription — Get call transcription text for a message
• Get Object Record — Get a specific record by ID from a custom or standard object
• Get Object Schema — Get object schema details by key including all fields and properties for custom or standard objects
• Get Opportunity — Get detailed information about a specific opportunity by ID
• Get Pipelines — Get all sales pipelines configured in GoHighLevel
• Get Platform Accounts — Get available accounts for a specific platform after OAuth
• Get Recent Messages — Get recent messages across all conversations for monitoring
• Get Smart List Contacts — Emulate Smart Lists by returning contacts that match tag filters.
• Get Social Accounts — Get all connected social media accounts and groups
• Get Social Categories — Get social media post categories
• Get Social Category — Get a specific social media category by ID
• Get Social Post — Get details of a specific social media post
• Get Social Tags — Get social media post tags
• Get Social Tags By Ids — Get specific social media tags by their IDs
• Get Timezones — Get available timezones for location configuration
• List Custom Fields — List custom fields for a location (alias for get_location_custom_fields).
• List Custom Values — List custom values for a location (alias for get_location_custom_values).
• List Tags — List tags for a location (alias for get_location_tags).
• List Tenants — List available tenant IDs for this MCP server. If a new subaccount is needed, use addTenantUrl from the response.
• List Users — List users for a location, optionally filtered by name or email.
• Resolve Calendar — Resolve a calendar by name and return its ID.
• Resolve Location — Agency-only GHL operation. Requires agency capability verification.
• Resolve Pipeline — Resolve a pipeline by name and return its ID.
• Resolve Stage — Resolve a pipeline stage by name and return its stage ID.
• Resolve Tenant By Location — Resolve a tenant ID from a location ID using the tenant map.
• Resolve User — Resolve a user by name or email and return the user ID.
• Search Contacts — Find contacts by query, email, or phone.
• Search Conversations — Search conversations in GoHighLevel with various filters
• Search Location Tasks — Search tasks within a location with advanced filtering
• Search Locations — Agency-only GHL operation. Requires agency capability verification.
• Search Object Records — Search records within a custom or standard object using searchable properties
• Search Opportunities — Filter opportunities by pipeline, stage, and status.
• Search Social Posts — Search and filter social media posts across all platforms

POST Tools

• Add Contact Followers — Add followers to a contact
• Add Contact Tags — Add tags to a contact
• Add Contact To Campaign — Add contact to a marketing campaign
• Add Contact To Workflow — Add contact to a workflow
• Add Inbound Message — Manually add an inbound message to a conversation
• Add Opportunity Followers — Add followers to an opportunity for notifications and tracking
• Add Outbound Call — Manually add an outbound call record to a conversation
• Agency Get Location — Agency-only GHL operation. Requires agency capability verification.
• Agency List Locations — Agency-only GHL operation. Requires agency capability verification.
• Agency Search Users — Agency-only GHL operation. Requires agency capability verification.
• Audit Inventory Snapshot — Return raw, normalized, and QA-scored inventory across core assets.
• Audit List Calendar Groups — List calendar groups for QA or review.
• Audit List Calendars — List calendars for QA or review.
• Audit List Campaigns — List campaigns for QA or review.
• Audit List Custom Fields — List location custom fields for QA or review.
• Audit List Custom Values — List location custom values for QA or review.
• Audit List Email Campaigns — List email campaigns for QA or review.
• Audit List Email Templates — List email templates for QA or review.
• Audit List Funnel Pages — List funnel pages for QA or review.
• Audit List Funnel Pages All — List all funnel pages for a funnel using auto-pagination.
• Audit List Funnels — List funnels for QA or review.
• Audit List Location Templates — List SMS/Email templates for a location for QA or review.
• Audit List Pipelines — List pipelines and stages for QA or review.
• Audit List Tags — List location tags for QA or review.
• Audit List Workflows — List workflows with status for QA or review.
• Bulk Delete Social Posts — Delete multiple social media posts at once (max 50)
• Bulk Update Contact Business — Bulk update business association for multiple contacts
• Bulk Update Contact Tags — Bulk add or remove tags from multiple contacts
• Cancel Scheduled Email — Cancel a scheduled email before it is sent
• Cancel Scheduled Message — Cancel a scheduled message before it is sent
• Check URL Slug — Check if a URL slug is available for use. Use this before creating or updating blog posts to ensure unique URLs.
• Conversation Create Followup Task — Create (or preview) a follow-up task using a conversation ID.
• Conversation Unread Digest — Summarize unread conversations with last message context.
• Conversation Unread Followup Batch — Summarize unread conversations and optionally create follow-up tasks.
• Create Appointment — Book an appointment for a contact in a target calendar.
• Create Appointment Note — Create a note for an appointment
• Create Association — Create a new association that defines relationship types between entities like contacts, custom objects, and opportunities.
• Create Block Slot — Create a blocked time slot to prevent bookings during specific times
• Create Blog Post — Create a new blog post in GoHighLevel. Requires blog ID, author ID, and category IDs which can be obtained from other blog tools.
• Create Calendar — Create a new calendar in GoHighLevel
• Create Calendar Group — Create a new calendar group
• Create Calendar Notifications — Create calendar notifications
• Create Calendar Resource Equipment — Create a calendar equipment resource
• Create Calendar Resource Room — Create a calendar room resource
• Create Contact — Create a new contact in GoHighLevel
• Create Contact Note — Create a new note for a contact
• Create Contact Task — Create a new task for a contact
• Create Conversation — Create a new conversation with a contact
• Create Custom Field — Create a new custom field for custom objects or company (business). Supports various field types including text, number, options, date, file upload, etc.
• Create Custom Field Folder — Create a new custom field folder for organizing fields within an object.
• Create Email Template — Create a new email template in GoHighLevel.
• Create Location — Create a new sub-account/location in GoHighLevel (Agency Pro plan required)
• Create Location Custom Field — Create a new custom field for a location
• Create Location Custom Value — Create a new custom value for a location
• Create Location Tag — Create a new tag for a location
• Create Object Record — Create a new record in a custom or standard object with properties, owner, and followers
• Create Object Schema — Create a new custom object schema with labels, key, and primary display property
• Create Opportunity — Create a new opportunity in GoHighLevel CRM
• Create Pipeline — Create a new sales pipeline with one or more stages.
• Create Pipeline Stage — Create a new stage inside an existing pipeline.
• Create Price — Create a price for a product
• Create Product — Create a new product in GoHighLevel
• Create Product Collection — Create a new product collection
• Create Relation — Create a relation between two entities using an existing association. Links specific records together.
• Create Shipping Carrier — Create a new shipping carrier for dynamic rate calculation
• Create Shipping Rate — Create a new shipping rate for a shipping zone
• Create Shipping Zone — Create a new shipping zone with specific countries and states
• Create Social Post — Create a new social media post for multiple platforms
• Create Store Setting — Create or update store settings including shipping origin and notifications
• Current Context — Return the current tenant routing context and defaults for this MCP server.
• Delete Appointment — Cancel/delete an appointment from GoHighLevel
• Delete Appointment Note — Delete an appointment note
• Delete Association — Delete a user-defined association. This will also delete all relations created with this association.
• Delete Calendar — Delete a calendar from GoHighLevel
• Delete Calendar Group — Delete a calendar group
• Delete Calendar Notification — Delete calendar notification
• Delete Calendar Resource Equipment — Delete an equipment resource
• Delete Calendar Resource Room — Delete a room resource
• Delete Contact — Delete a contact from GoHighLevel
• Delete Contact Note — Delete a note for a contact
• Delete Contact Task — Delete a task for a contact
• Delete Conversation — Delete a conversation permanently
• Delete Custom Field — Delete a custom field by ID. This will permanently remove the field and its data.
• Delete Custom Field Folder — Delete a custom field folder. This will also affect any fields within the folder.
• Delete Email Template — Delete an email template from GoHighLevel.
• Delete Location — Delete a sub-account/location from GoHighLevel
• Delete Location Custom Field — Delete a custom field from a location
• Delete Location Custom Value — Delete a custom value from a location
• Delete Location Tag — Delete a location tag
• Delete Location Template — Delete a template from a location
• Delete Media File — Delete a specific file or folder from the media library
• Delete Object Record — Delete a record from a custom or standard object
• Delete Opportunity — Delete an opportunity from GoHighLevel CRM
• Delete Product — Delete a product by ID
• Delete Relation — Delete a specific relation between two entities.
• Delete Shipping Carrier — Delete a shipping carrier
• Delete Shipping Rate — Delete a shipping rate
• Delete Shipping Zone — Delete a shipping zone and all its associated shipping rates
• Delete Social Account — Delete a social media account connection
• Delete Social Post — Delete a social media post
• Disable Calendar Group — Enable or disable a calendar group
• Download Transcription — Download call transcription as a text file
• Get All Associations — Get all associations for a sub-account/location with pagination. Returns system-defined and user-defined associations.
• Get Association By ID — Get a specific association by its ID. Works for both system-defined and user-defined associations.
• Get Association By Key — Get an association by its key name. Useful for finding both standard and user-defined associations.
• Get Association By Object Key — Get associations by object keys like contacts, custom objects, and opportunities.
• Get Available Shipping Rates — Get available shipping rates for an order based on destination and order details
• Get Custom Field By ID — Get a custom field or folder by its ID. Supports custom objects and company (business) fields.
• Get Custom Fields By Object Key — Get all custom fields and folders for a specific object key (e.g., custom object or company).
• Get Product — Get a specific product by ID
• Get Relations By Record — Get all relations for a specific record ID with pagination and optional filtering by association IDs.
• Get Shipping Carrier — Get details of a specific shipping carrier
• Get Shipping Rate — Get details of a specific shipping rate
• Get Shipping Zone — Get details of a specific shipping zone
• Get Store Setting — Get current store settings
• Get Survey Submissions — Retrieve survey submissions with advanced filtering and pagination. Get responses from contacts who have completed surveys.
• Get Surveys — Retrieve all surveys for a location. Surveys are used to collect information from contacts through forms and questionnaires.
• Get Workflows — Retrieve all workflows for a location. Workflows represent automation sequences that can be triggered by various events in the system.
• List Inventory — List inventory items with stock levels
• List Prices — List prices for a product
• List Product Collections — List product collections
• List Products — List products with optional filtering
• List Shipping Carriers — List all shipping carriers for a location
• List Shipping Rates — List all shipping rates for a specific shipping zone
• List Shipping Zones — List all shipping zones for a location
• Live Chat Typing — Send typing indicator for live chat conversations
• Opportunities Get Pipelines — Legacy alias for get_pipelines (kept for compatibility).
• Opportunities Get Pipelines — Legacy alias for get_pipelines (kept for compatibility).
• Remove Contact Followers — Remove followers from a contact
• Remove Contact From All Campaigns — Remove contact from all campaigns
• Remove Contact From Campaign — Remove contact from a specific campaign
• Remove Contact From Workflow — Remove contact from a workflow
• Remove Contact Tags — Remove tags from a contact
• Remove Opportunity Followers — Remove followers from an opportunity
• Send Email — Send an email message to a contact in GoHighLevel
• Send Sms — Send an SMS message to a contact in GoHighLevel
• Set Active Location — Set the default tenant by location ID (server memory only).
• Set Active Tenant — Set the default tenant for subsequent calls (server memory only).
• Set Csv Accounts — Set accounts for CSV import processing
• Spec Gap Checklist — Return a checklist of recommended validation steps before shipping changes.
• Start Social Oauth — Start OAuth process for social media platform
• Status Self Test — Run a self-test: routing, one read call, and one dry-run write check.
• Tasks Close By Query — Mark tasks as completed based on a keyword or query.
• Tasks Daily Summary By Assignee — Generate a daily task summary grouped by assignee.
• Tasks List By Assignee — List tasks for a specific assignee using GHL user ID or team directory lookup.
• Tasks Normalize Due Dates — Normalize task due times to a specific time of day in the location timezone.
• Tasks Push Overdue To Next Business Day — Move overdue tasks to the next business day at a specific time.
• Tasks Reassign By Keyword — Reassign tasks matching a keyword or query.
• Team Directory List — List Discord-to-GHL team mappings.
• Team Directory Lookup — Lookup a team directory entry by Discord ID or name.
• Team Directory Remove — Remove a team directory entry by Discord ID.
• Team Directory Upsert — Create or update a team directory entry.
• Update Appointment — Update an existing appointment in GoHighLevel
• Update Appointment Note — Update an appointment note
• Update Association — Update the labels of an existing association. Only user-defined associations can be updated.
• Update Block Slot — Update an existing blocked time slot
• Update Blog Post — Update an existing blog post in GoHighLevel. All fields except postId and blogId are optional.
• Update Calendar — Update an existing calendar in GoHighLevel
• Update Calendar Group — Update calendar group details
• Update Calendar Notification — Update calendar notification
• Update Calendar Resource Equipment — Update equipment resource details
• Update Calendar Resource Room — Update room resource details
• Update Contact — Update contact information
• Update Contact Note — Update a note for a contact
• Update Contact Task — Update a task for a contact
• Update Conversation — Update conversation properties (star, mark read, etc.)
• Update Custom Field — Update an existing custom field by ID. Can modify name, description, options, and other properties.
• Update Custom Field Folder — Update the name of an existing custom field folder.
• Update Email Template — Update an existing email template in GoHighLevel.
• Update Location — Update an existing sub-account/location in GoHighLevel
• Update Location Custom Field — Update an existing custom field
• Update Location Custom Value — Update an existing custom value
• Update Location Tag — Update an existing location tag
• Update Message Status — Update the delivery status of a message
• Update Object Record — Update an existing record in a custom or standard object
• Update Object Schema — Update object schema properties including labels, description, and searchable fields
• Update Opportunity — Update an existing opportunity with new details (full update)
• Update Opportunity Status — Update the status of an opportunity (won, lost, etc.)
• Update Product — Update an existing product
• Update Shipping Carrier — Update a shipping carrier's properties
• Update Shipping Rate — Update a shipping rate's properties
• Update Shipping Zone — Update a shipping zone's name or countries
• Update Social Post — Update an existing social media post
• Update Task Completion — Update task completion status
• Upload Media File — Upload a file to the media library or add a hosted file URL (max 25MB for direct uploads)
• Upload Message Attachments — Upload file attachments for use in messages
• Upload Social Csv — Upload CSV file for bulk social media posts
• Upsert Contact — Create or update a contact idempotently.
• Upsert Opportunity — Create or update an opportunity based on contact and pipeline (smart merge)
• Validate Group Slug — Validate if a calendar group slug is available
• Verify Email — Verify email address deliverability and get risk assessment. Charges will be deducted from the specified location wallet.
• Whoami — Return the current tenant routing context and defaults for this MCP server.