GoHighLevel MCP Server

A Model Context Protocol (MCP) server providing access to the complete GoHighLevel API. This server enables AI assistants like Claude to interact with GoHighLevel’s services including contacts, opportunities, calendars, workflows, and more.

🚀 Quick Start

npx @drausal/gohighlevel-mcp

Or install globally:

npm install -g @drausal/gohighlevel-mcp

🚀 Features

• Complete API Coverage: Access to all GoHighLevel API endpoints
• OAuth2 Support: Automatic token management and refresh
• Bearer Token Auth: Simple API key authentication
• Type-Safe: Full TypeScript implementation with Zod validation
• Stdio Transport: Works with Claude Desktop and other MCP clients
• Auto-Generated: Built from the official OpenAPI specification

📋 Prerequisites

• Node.js >= 20.0.0
• A GoHighLevel account with API access
• API credentials (Bearer token or OAuth2 client credentials)

🔧 Installation

Quick Start with npx (Recommended)

No installation needed! Use npx to run the server directly:

npx @drausal/gohighlevel-mcp

Alternative: Install Globally

For permanent installation:

npm install -g @drausal/gohighlevel-mcp

Then run:

gohighlevel-mcp

From Source (Development)

For development or customization:

git clone https://github.com/drausal/gohighlevel-mcp.git
cd gohighlevel-mcp
pnpm install
pnpm run build
pnpm start

🎯 Usage

Claude Desktop Configuration

Add this to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

Using npx (Recommended):

{
  "mcpServers": {
    "gohighlevel": {
      "command": "npx",
      "args": [
        "@drausal/gohighlevel-mcp"
      ],
      "env": {
        "BEARER_TOKEN_BEARERAUTH": "your_api_key_here",
        "BEARER_TOKEN_BEARER": "your_api_key_here"
      }
    }
  }
}

Using global installation:

{
  "mcpServers": {
    "gohighlevel": {
      "command": "gohighlevel-mcp",
      "args": [],
      "env": {
        "BEARER_TOKEN_BEARERAUTH": "your_api_key_here",
        "BEARER_TOKEN_BEARER": "your_api_key_here"
      }
    }
  }
}

Using local installation:

{
  "mcpServers": {
    "gohighlevel": {
      "command": "node",
      "args": [
        "/absolute/path/to/gohighlevel-mcp/build/index.js"
      ],
      "env": {
        "BEARER_TOKEN_BEARERAUTH": "your_api_key_here",
        "BEARER_TOKEN_BEARER": "your_api_key_here"
      }
    }
  }
}

Warp Terminal Configuration

For Warp users, use the npx method:

{
  "mcpServers": {
    "gohighlevel": {
      "command": "npx",
      "args": [
        "@drausal/gohighlevel-mcp"
      ],
      "env": {