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
Or install globally:
š 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:
Alternative: Install Globally
For permanent installation:
Then run:
From Source (Development)
For development or customization:
šÆ Usage
Claude Desktop Configuration
Add this to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json
on macOS):
Using npx (Recommended):
Using global installation:
Using local installation:
Warp Terminal Configuration
For Warp users, use the npx method:
Running Standalone
š Authentication
Bearer Token
The simplest authentication method. Get your API key from GoHighLevel:
Log into your GoHighLevel account
Go to Settings ā API
Copy your API key
Set
BEARER_TOKEN_BEARERAUTH
in your.env
file
OAuth2
For more advanced use cases with automatic token refresh:
Agency Access: For agency-level operations
Set
OAUTH_CLIENT_ID_AGENCY_ACCESS
andOAUTH_CLIENT_SECRET_AGENCY_ACCESS
Location Access: For location-specific operations
Set
OAUTH_CLIENT_ID_LOCATION_ACCESS
andOAUTH_CLIENT_SECRET_LOCATION_ACCESS
The server automatically:
Obtains access tokens using client credentials flow
Caches tokens for their lifetime
Refreshes tokens when expired
See docs/oauth2-configuration.md
for detailed OAuth2 configuration.
š Available Tools
The MCP server exposes all GoHighLevel API endpoints as MCP tools. Major categories include:
Core Resources
Contacts: Create, update, search contacts
Opportunities: Manage sales pipeline
Calendars: Schedule appointments
Workflows: Trigger and manage automation
Communication
Conversations: Messaging and chat
Emails: Email campaigns and templates
SMS: Text message campaigns
Marketing
Social Media Posting: Manage social campaigns
Blogs: Content management
Forms: Lead capture
Business Management
Payments: Process transactions
Invoices: Billing management
Users: Team and permission management
Locations: Sub-account management
To see all available tools, the MCP client will list them when connecting to the server.
š ļø Development
Project Structure
Scripts
pnpm run build
- Compile TypeScript to JavaScriptpnpm start
- Run the compiled serverpnpm run typecheck
- Check TypeScript types without building
Type Safety
This server uses:
Zod for runtime validation of inputs and outputs
TypeScript for compile-time type checking
json-schema-to-zod for generating validators from OpenAPI schemas
š Documentation
š Troubleshooting
Server Won't Start
Check Node.js version:
node --version # Should be >= 20.0.0Verify build succeeded:
ls -la build/index.jsCheck environment variables:
cat .env
Authentication Errors
Bearer Token: Verify your API key is correct
OAuth2: Ensure client ID and secret are valid
Check token expiration (OAuth2 tokens expire after 1 hour)
Claude Desktop Integration Issues
Verify the absolute path in
claude_desktop_config.json
Restart Claude Desktop after configuration changes
Check Claude Desktop logs for error messages
Common Issues
"ENOENT" errors: Usually means the path in config is incorrect
"Permission denied": Run chmod +x build/index.js
"Invalid token": Check your API credentials in .env
š¤ Contributing
This project is auto-generated from the GoHighLevel OpenAPI specification. To update:
Download the latest OpenAPI spec from GoHighLevel
Run the generator again:
npx openapi-mcp-generator -i openapi.json -o . -n gohighlevel --forceReinstall dependencies and rebuild
š License
This MCP server is generated from GoHighLevel's public API specification. Please refer to GoHighLevel's terms of service for API usage guidelines.
š Support
GoHighLevel API Issues: Contact GoHighLevel support
MCP Protocol Issues: See MCP Documentation
Server Issues: Check this README and troubleshooting section
š Acknowledgments
Built with openapi-mcp-generator
Powered by GoHighLevel's comprehensive API
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables AI assistants to interact with GoHighLevel's complete API including contacts, opportunities, calendars, workflows, communications, and business management tools. Supports both Bearer token and OAuth2 authentication with automatic token management.