GoHighLevel MCP Server

How to use

You use this MCP server by running it locally or deploying it to a hosting platform, then connecting your MCP client (such as Claude Desktop or another MCP-enabled client) to the server. The server exposes a wide range of GoHighLevel data and actions, allowing you to search and manage contacts, send messages, schedule appointments, handle opportunities, manage invoices and payments, and automate many business processes. Start by configuring your MCP client to point at the server endpoint, then issue high-level commands that map to GoHighLevel API actions. You can build automated workflows, orchestrate multi-step tasks, and surface GoHighLevel data inside your AI assistant for faster decisions and actions.

How to install

# Prerequisites
- Node.js 18+ (Latest LTS recommended)
- GoHighLevel account with API access
- Private Integrations API key from your GoHighLevel account
- Location ID from Settings → Company → Locations
- Claude Desktop setup for MCP integration (optional but recommended)

# Clone the MCP server project
git clone https://github.com/mastanley13/GoHighLevel-MCP.git
cd GoHighLevel-MCP

# Install dependencies
npm install

# Create environment file and configure credentials
cp .env.example .env
# Set values in .env

# Build the project
npm run build

# Start the server
npm start

# For development with hot reload
npm run dev

Configuration & deployment options

Environment variables you need to configure include the GoHighLevel Private Integrations API key, the base URL for the GHL API, and your location ID. The example below shows the required variables and their typical usage.

# Required Environment Variables
GHL_API_KEY=your_private_integrations_api_key_here
GHL_BASE_URL=https://services.leadconnectorhq.com
GHL_LOCATION_ID=your_location_id_here
NODE_ENV=production

# Optional Configuration
PORT=8000
CORS_ORIGINS=*
LOG_LEVEL=info

Claude Desktop integration and deployment options

To enable Claude Desktop to drive this MCP server, you can configure Claude Desktop to run the local server or connect to a deployed HTTP endpoint. The integration example shows running the server via Node.js and pointing Claude Desktop to the compiled server file. You can also deploy the server to popular hosts for production usage.

# Claude Desktop MCP configuration (example)
{
  "mcpServers": {
    "ghl_mcp_server": {
      "command": "node",
      "args": ["path/to/ghl-mcp-server/dist/server.js"],
      "env": {
        "GHL_API_KEY": "your_private_integrations_api_key",
        "GHL_BASE_URL": "https://services.leadconnectorhq.com",
        "GHL_LOCATION_ID": "your_location_id"
      }
    }
  }
}
```

### HTTP MCP endpoint (for web clients)

Use this endpoint to connect web-based MCP clients: https://your-deployment-url.vercel.app/sse

Troubleshooting and notes

If you encounter connection or API errors, verify that you are using a Private Integrations API key (not a regular API key), that the required scopes are granted, and that the Location ID matches your GoHighLevel account. Ensure environment variables are correctly set and that the server is reachable from the client. For memory or startup issues, adjust Node.js memory limits or review your deployment size.

# Common issues quick checks
curl -H "Authorization: Bearer YOUR_PRIVATE_INTEGRATIONS_API_KEY" \
     https://services.leadconnectorhq.com/locations/YOUR_LOCATION_ID

create_contact

Create a new contact in GoHighLevel with specified fields.

update_contact

Update an existing contact's information.

search_contacts

Query contacts based on filters and return results.

get_contact

Retrieve details for a specific contact.

send_sms

Send an SMS message to a contact or group.