GHL CLI 🚀

Command-line interface for GoHighLevel CRM via MCP.

Manage contacts, conversations, calendar, opportunities, and payments from your terminal.

Installation

npm install -g ghl-cli

Setup

ghl auth

You'll need:

1. Private Integration Token (PIT) - from Settings > Private Integrations in GHL
2. Location ID - your sub-account ID

Usage

Contacts

ghl contacts list              # List contacts
ghl contacts get <id>          # Get contact details
ghl contacts create --name "John Doe" --email [email protected]
ghl contacts tag <id> lead hot # Add tags
ghl contacts tasks <id>        # Get tasks for contact

Conversations

ghl conv search                # Search conversations
ghl conv messages <id>         # Get messages
ghl conv send <id> "Hello!"    # Send SMS
ghl conv send <id> "Hello!" --type Email

Calendar

ghl cal events                 # List calendar events
ghl cal notes <appointmentId>  # Get appointment notes

Opportunities

ghl opp pipelines              # List pipelines
ghl opp search                 # Search opportunities
ghl opp get <id>               # Get opportunity details
ghl opp update <id> --status won --value 5000

Payments

ghl pay transactions           # List transactions
ghl pay order <id>             # Get order details

Location

ghl loc info                   # Get location details
ghl loc fields                 # List custom fields

Environment Variables

Instead of ghl auth, you can set:

export GHL_TOKEN="pit-xxxxx"
export GHL_LOCATION_ID="xxxxx"

License

MIT © Quentin Daems

Credits

Built with LoopShip 🚀 Uses GoHighLevel MCP