GHL MCP Server

HighLevel Model Context Protocol integration for Real Talk HA. AI-powered access to contacts, conversations, opportunities, payments, blogs, social media, and more.

36 Tools Connected • Live • Location: ifitVy09cFwlEVgEAFDS
LIVE
Connection Status
36
MCP Tools
8
Tool Categories
v1.0
Protocol Version

Quick Start

1

MCP Config (Cursor, Windsurf, OpenAI Playground)

Add this to your MCP client configuration:

{
    "mcpServers": {
        "ghl-mcp": {
            "url": "https://services.leadconnectorhq.com/mcp/",
            "headers": {
                "Authorization": "Bearer $GHL_PIT_TOKEN",
                "locationId": "ifitVy09cFwlEVgEAFDS"
            }
        }
    }
}
2

Python (Direct API)

Use our Python client for scripted access:

from ghl_mcp_client import GHLMCPClient
import asyncio

async def main():
    client = GHLMCPClient(
        pit_token="$GHL_PIT_TOKEN",
        location_id="ifitVy09cFwlEVgEAFDS"
    )
    async with client.connect():
        # List all tools
        tools = await client.list_tools()

        # Get contacts
        result = await client.call_tool("contacts_get-contacts", {
            "query_limit": "10",
            "query_locationId": "ifitVy09cFwlEVgEAFDS"
        })
        print(result)

asyncio.run(main())
3

n8n Integration (v1.104+)

Configure MCP Client node with HTTP Streamable transport:

MCP URL:    https://services.leadconnectorhq.com/mcp/
Transport:  HTTP Streamable
Auth Type:  Header Auth
  Key:      Authorization
  Value:    Bearer $GHL_PIT_TOKEN

System Prompt (in LLM node):
  "The location id is ifitVy09cFwlEVgEAFDS"
4

GHL Automation Webhook Body

Standard webhook payload for all GHL workflow automations (Agent Studio → n8n/Make):

{
  "contactId": "{{custom_values.contact_id}}",
  "locationId": "{{custom_values.location_id}}",
  "pit_token": "{{custom_values.ghl_pit}}",
  "tags": "{{custom_values.contact_tags}}",
  "website": "{{contact.website}}",
  "social_media_links": "{{custom_values.social_media_links}}"
}

All 36 MCP Tools

All (36) Contacts (7) Conversations (3) Opportunities (4) Calendars (2) Payments (2) Social Media (6) Blogs (7) Emails (2) Locations (2)
contacts_get-contactscontacts

Get contacts from GHL with filtering and pagination

contacts_get-contactcontacts

Fetch detailed contact information by ID

contacts_create-contactcontacts

Create a new contact in GHL

contacts_update-contactcontacts

Update an existing contact's fields

contacts_upsert-contactcontacts

Update or create a contact (smart merge)

contacts_add-tagscontacts

Add tags to a contact for segmentation

contacts_remove-tagscontacts

Remove tags from a contact

contacts_get-all-taskscontacts

Get all tasks assigned to a contact

conversations_search-conversationconversations

Search, filter, and sort conversations

conversations_get-messagesconversations

Get messages by conversation ID

conversations_send-a-new-messageconversations

Send SMS, email, or chat message into a thread

opportunities_get-pipelinesopportunities

Retrieve all opportunity pipelines

opportunities_search-opportunityopportunities

Search for opportunities by criteria

opportunities_get-opportunityopportunities

Fetch a single opportunity by ID

opportunities_update-opportunityopportunities

Update an existing opportunity

calendars_get-calendar-eventscalendars

Get calendar events (requires userId, groupId, or calendarId)

calendars_get-appointment-notescalendars

Retrieve notes attached to appointments

payments_get-order-by-idpayments

Fetch order details by unique order ID

payments_list-transactionspayments

Paginated transaction list with filtering

social-media-posting_get-accountsocial

List connected social media accounts

social-media-posting_get-postssocial

Retrieve social media posts

social-media-posting_get-postsocial

Get details for a specific post

social-media-posting_create-postsocial

Create a new post for multiple platforms

social-media-posting_edit-postsocial

Modify an existing social media post

social-media-posting_get-social-media-statisticssocial

Retrieve analytics for social accounts

blogs_get-blogsblogs

List all blog sites

blogs_get-blog-postblogs

Retrieve blog posts for a blog site

blogs_create-blog-postblogs

Create a new blog post

blogs_update-blog-postblogs

Modify an existing blog post

blogs_check-url-slug-existsblogs

Check if a URL slug is available

blogs_get-all-categories-by-locationblogs

Get all blog categories for a location

blogs_get-all-blog-authors-by-locationblogs

Get all blog authors for a location

emails_fetch-templateemails

Retrieve email templates for a location

emails_create-templateemails

Create a new email template

locations_get-locationlocations

Get sub-account (location) details by ID

locations_get-custom-fieldslocations

Retrieve custom field definitions

What You Can Do

Contact Management on Autopilot

Fetch, update, or create contacts via AI prompts. Tag and segment contacts for targeted campaigns. "Show me all contacts added last week and tag them as 'New Lead'"

Conversational AI That Texts for You

Send messages to any conversation. Search by keywords, status, or participant. "Find all unread messages and send a follow-up"

Pipeline & Deal Intelligence

Search opportunities, move deals between stages, update values. "Show me all open deals over $5k in the Sales pipeline"

Payment & Transaction Analytics

Fetch order details and transaction history on demand. "Show me the last 10 transactions over $100"

Blog & Social Media Automation

Create and edit blog posts, manage social media content across platforms. "Draft a blog post about AI automation and schedule it"

Multi-Step Workflow Chains

Chain MCP actions: on new contact, tag them, send a welcome message, add to pipeline. All through natural language.

Required PIT Scopes

Your Private Integration Token needs these scopes for full access:

View Contacts
Edit Contacts
View Conversations
Edit Conversations
View Conversation Messages
Edit Conversation Messages
View Opportunities
Edit Opportunities
View Calendars
Edit Calendars
View Calendar Events
Edit Calendar Events
View Payment Orders
View Payment Transactions
View Custom Fields
View Locations
View Social Media Posts
Edit Social Media Posts
View Social Media Accounts
socialplannerstatisticsreadonly
View Email Templates
Create/Update/Delete Email Templates
blogslistreadonly
blogspostsreadonly
View Blog Authors
View Blog Categories
Create Blog Post
Update Blog Post
Check Blog Post Slug

Deliverables