GHL

You can connect Claude Desktop or web clients to your GoHighLevel account using this MCP server to automate and orchestrate data across contacts, opportunities, calendars, invoices, blogs, and more. It exposes a broad set of GoHighLevel API capabilities through MCP so you can build AI-powered workflows, prompts, and integrations with confidence and security.

How to use

You will run an MCP client that talks to the GoHighLevel MCP Server. Start with the HTTP connection if you have a deployed server, and fall back to the local CLI server if you want to run everything on your machine.

How to install

Prerequisites: you need Node.js 18+ (latest LTS recommended), a GoHighLevel account with API access, and a valid Private Integrations API key from your GoHighLevel account. You also need a Location ID from Settings → Company → Locations.

Step-by-step setup for a local development environment:

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

# Install dependencies
npm install

# Create and configure environment variables
cp .env.example .env
# Edit .env to set GHL_API_KEY, GHL_BASE_URL, GHL_LOCATION_ID, NODE_ENV

# Build the project
npm run build

# Start the server (production)
npm start

# For development with hot reload
npm run dev

Additional configuration and usage notes

Environment variables you will configure include GHL_API_KEY, GHL_BASE_URL, and GHL_LOCATION_ID. Use the Private Integrations API key from your GoHighLevel account, not a regular API key. The base URL is typically https://services.leadconnectorhq.com, and the Location ID comes from Settings → Company → Locations.

Claude Desktop integration is supported via MCP settings. The standard CLI MCP server can be launched with npm start and the development variant with npm run dev. For Claude Desktop, you will point to the MCP server via a CLI or HTTP interface and ensure the environment variables are set before starting.

If you deploy to the cloud, you can expose an HTTP MCP endpoint for web clients. Use the SSE endpoint https://your-deployment-url.vercel.app/sse for real-time updates.

Security and best practices

Only use Private Integrations API keys and scope the integration to the necessary permissions. Treat your credentials as secrets: do not commit them to version control, rotate keys regularly, and limit access to trusted teammates.

Implement rate limiting and memory safeguards in your deployment. Monitor GoHighLevel API usage to avoid hitting rate limits and cache frequently requested data when appropriate.

Troubleshooting

If you encounter connectivity issues, verify that your GHL_API_KEY and GHL_LOCATION_ID are correct and that the base URL matches your account. Test connectivity with a simple request to your location endpoint using your private key.

For build or runtime issues, clear caches and reinstall dependencies, then rebuild and restart the server. Check that your environment variables are loaded correctly before starting.

Claude Desktop usage examples

You can drive workflows by composing natural language prompts that leverage the full MCP tool catalog. Examples include creating contact records, managing opportunities, and scheduling appointments through AI-assisted prompts.

Deployment options

You can deploy the MCP server to Vercel, Railway, or Render for production workloads. Each option provides different benefits, such as free tiers, automatic HTTPS, and easy scaling.

Project architecture overview

The MCP server is built with TypeScript on Node.js and exposes a comprehensive set of GoHighLevel operations organized into tools that cover contacts, conversations, calendars, invoices, blogs, locations, social media, objects, workflows, and more. The server uses an MCP client to communicate with the GoHighLevel API and exposes an SSE endpoint for real-time updates to MCP clients.

Available tools

create_contact

Create a new contact with the specified details.

search_contacts

Find contacts matching given criteria.

get_contact

Retrieve a contact by ID.

update_contact

Update contact information.

delete_contact

Remove a contact.

send_sms

Send an SMS message to a contact.

send_email

Send an email to a contact.

create_opportunity

Create a new sales opportunity.

update_opportunity

Update an existing opportunity.

get_calendar_events

Retrieve calendar events for a location or user.

create_appointment

Create a new appointment in the calendar.

get_invoice

Fetch an invoice by ID.

create_blog_post

Create a new blog post.

search_locations

Search and filter location records.

verify_email

Verify an email address for deliverability.

search_social_posts

Search connected social media posts.

upload_media_file

Upload a media asset to the library.

ghl_get_all_associations

Retrieve all object associations.