Connects AI agents like Claude Desktop to the GoHighLevel CRM platform
Instead of trying to tackle this ---- use our hosted version --- GHL Agent Framework, One Click to Sign in!
https://www.strategixagents.com/
🚀 GoHighLevel MCP Server
🚨 **IMPORTANT: FOUNDATIONAL PROJECT NOTICE**
⚠️ This is a BASE-LEVEL foundational project designed to connect the GoHighLevel community with AI automation through MCP (Model Context Protocol).
**🎯 What This Project Is:**
- Foundation Layer: Provides access to ALL sub-account level GoHighLevel API endpoints via MCP
- Community Starter: Built to get the community moving forward together, faster
- Open Architecture: API client and types can be further modularized and segmented as needed
- Educational Resource: Learn how to integrate GoHighLevel with AI systems
**⚠️ Critical AI Safety Considerations:**
- Memory/Recall Systems: If you don't implement proper memory or recall mechanisms, AI may perform unintended actions
- Rate Limiting: Monitor API usage to avoid hitting GoHighLevel rate limits
- Permission Controls: Understand that this provides FULL access to your sub-account APIs
- Data Security: All actions are performed with your API credentials - ensure proper security practices
**🎯 Intended Use:**
- Personal/Business Use: Integrate your own GoHighLevel accounts with AI
- Development Base: Build upon this foundation for custom solutions
- Learning & Experimentation: Understand GoHighLevel API patterns
- Community Contribution: Help improve and extend this foundation
**🚫 NOT Intended For:**
- Direct Resale: This is freely available community software
- Production Without Testing: Always test thoroughly in development environments
- Unmonitored AI Usage: Implement proper safeguards and monitoring
🔑 **CRITICAL: GoHighLevel API Setup**
**📋 Required: Private Integrations API Key**
⚠️ This project requires a PRIVATE INTEGRATIONS API key, not a regular API key!
How to get your Private Integrations API Key:
Login to your GoHighLevel account
Navigate to Settings → Integrations → Private Integrations
Create New Private Integration:
- Name:
MCP Server Integration(or your preferred name) - Webhook URL: Leave blank (not needed)
- Name:
Select Required Scopes based on tools you'll use:
- ✅ contacts.readonly - View contacts
- ✅ contacts.write - Create/update contacts
- ✅ conversations.readonly - View conversations
- ✅ conversations.write - Send messages
- ✅ opportunities.readonly - View opportunities
- ✅ opportunities.write - Manage opportunities
- ✅ calendars.readonly - View calendars/appointments
- ✅ calendars.write - Create/manage appointments
- ✅ locations.readonly - View location data
- ✅ locations.write - Manage location settings
- ✅ workflows.readonly - View workflows
- ✅ campaigns.readonly - View campaigns
- ✅ blogs.readonly - View blog content
- ✅ blogs.write - Create/manage blog posts
- ✅ users.readonly - View user information
- ✅ custom_objects.readonly - View custom objects
- ✅ custom_objects.write - Manage custom objects
- ✅ invoices.readonly - View invoices
- ✅ invoices.write - Create/manage invoices
- ✅ payments.readonly - View payment data
- ✅ products.readonly - View products
- ✅ products.write - Manage products
Save Integration and copy the generated Private API Key
Copy your Location ID from Settings → Company → Locations
💡 Tip: You can always add more scopes later by editing your Private Integration if you need additional functionality.
This project was a 'time-taker' but I felt it was important. Feel free to donate - everything will go into furthering this Project -> Aiming for Mass Agency "Agent Driven Operations".
🔥 Transform Claude Desktop into a complete GoHighLevel CRM powerhouse with 269+ powerful tools across 19+ categories
🎯 What This Does
This comprehensive MCP (Model Context Protocol) server connects Claude Desktop directly to your GoHighLevel account, providing unprecedented automation capabilities:
- 👥 Complete Contact Management: 31 tools for contacts, tasks, notes, and relationships
- 💬 Advanced Messaging: 20 tools for SMS, email, conversations, and call recordings
- 🏢 Business Operations: Location management, custom objects, workflows, and surveys
- **💰 Sa
Tools (6)
contacts.readonlyView and retrieve contact information from the CRM.contacts.writeCreate or update contact records in the sub-account.conversations.writeSend messages and interact with customer conversations.opportunities.writeManage sales opportunities and pipeline stages.calendars.writeCreate and manage calendar appointments.invoices.writeCreate and manage business invoices.Environment Variables
GHL_API_KEYrequiredPrivate Integrations API key from Settings -> IntegrationsGHL_LOCATION_IDrequiredLocation ID from Settings -> Company -> LocationsConfiguration
{
"mcpServers": {
"hailey-mcp": {
"command": "npx",
"args": ["-y", "@hooker-dev/hailey-mcp"],
"env": {
"GHL_API_KEY": "your_private_integration_api_key",
"GHL_LOCATION_ID": "your_location_id"
}
}
}
}