GoHighLevel MCP Server

# 🚀 GoHighLevel MCP Server [](https://vercel.com/new/clone?repository-url=https://github.com/mastanley13/GoHighLevel-MCP) [](https://buy.stripe.com/28E14o1hT7JAfstfvqdZ60y) > **Transform ChatGPT into a GoHighLevel CRM powerhouse with 21 powerful tools** ## 🎯 What This Does This MCP (Model Context Protocol) server connects ChatGPT directly to your GoHighLevel account, enabling you to: - **👥 Manage Contacts**: Create, search, update, and organize contacts - **💬 Handle Communications**: Send SMS and emails, manage conversations - **📝 Create Content**: Manage blog posts, authors, and categories - **🔄 Automate Workflows**: Combine multiple actions through ChatGPT ## 🔑 **CRITICAL: GoHighLevel API Setup** ### **📋 Required: Private Integrations API Key** > **⚠️ This project requires a PRIVATE INTEGRATIONS API key, not a regular API key!** **Quick Setup:** 1. **GoHighLevel Settings** → **Integrations** → **Private Integrations** 2. **Create New Integration** with required scopes (contacts, conversations, etc.) 3. **Copy the Private API Key** and your **Location ID** ## ⚡ Quick Deploy to Vercel ### 1. One-Click Deploy Click the button above or: [](https://vercel.com/new/clone?repository-url=https://github.com/mastanley13/GoHighLevel-MCP) ### 2. Add 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 ``` ### 3. Connect to ChatGPT Use your deployed URL in ChatGPT: ``` https://your-app-name.vercel.app/sse ``` ## 🛠️ Available Tools (21 Total) ### 🎯 Contact Management (7 Tools) - `create_contact` - Create new contacts - `search_contacts` - Find contacts by criteria - `get_contact` - Retrieve contact details - `update_contact` - Modify contact information - `add_contact_tags` - Organize with tags - `remove_contact_tags` - Remove tags - `delete_contact` - Delete contacts ### 💬 Messaging & Conversations (7 Tools) - `send_sms` - Send SMS messages - `send_email` - Send emails with HTML support - `search_conversations` - Find conversations - `get_conversation` - Get conversation details - `create_conversation` - Start new conversations - `update_conversation` - Modify conversations - `get_recent_messages` - Monitor recent activity ### 📝 Blog Management (7 Tools) - `create_blog_post` - Create blog posts with SEO - `update_blog_post` - Edit existing posts - `get_blog_posts` - List and search posts - `get_blog_sites` - Manage blog sites - `get_blog_authors` - Handle authors - `get_blog_categories` - Organize categories - `check_url_slug` - Validate URL slugs ## 🎮 ChatGPT Usage Examples ### Contact Management ``` "Create a contact for John Smith with email john@company.com and add tags 'lead' and 'hot-prospect'" ``` ### Communication ``` "Send an SMS to contact ID abc123 saying 'Thanks for your interest! We'll call you within 24 hours.'" ``` ### Blog Content ``` "Create a blog post titled 'Insurance Tips for 2024' with SEO-optimized content about life insurance benefits" ``` ### Advanced Workflows ``` "Search for contacts tagged 'VIP', get their recent conversations, and send them a personalized email about our premium services" ``` ## 🔧 Local Development ### Prerequisites - Node.js 18+ - GoHighLevel API access - Valid API key and Location ID ### Setup ```bash # Clone repository git clone https://github.com/mastanley13/GoHighLevel-MCP.git cd GoHighLevel-MCP # Install dependencies npm install # Create .env file cp .env.example .env # Add your GHL API credentials # Build and start npm run build npm start ``` ### Testing ```bash # Test health endpoint curl http://localhost:8000/health # Test tools endpoint curl http://localhost:8000/tools # Test SSE endpoint curl -H "Accept: text/event-stream" http://localhost:8000/sse ``` ## 🌐 Deployment Options ### Vercel (Recommended) - ✅ Free tier available - ✅ Automatic HTTPS - ✅ Global CDN - ✅ Easy GitHub integration ### Railway - ✅ Free $5 credit - ✅ Simple deployment - ✅ Automatic scaling ### Render - ✅ Free tier - ✅ Easy setup - ✅ Reliable hosting ## 📋 Project Structure ``` GoHighLevel-MCP/ ├── src/ │ ├── clients/ # GHL API client │ ├── tools/ # MCP tool implementations │ ├── types/ # TypeScript interfaces │ ├── server.ts # CLI MCP server │ └── http-server.ts # HTTP MCP server ├── tests/ # Comprehensive test suite ├── docs/ # Documentation ├── vercel.json # Vercel configuration ├── Dockerfile # Docker support └── README.md # This file ``` ## 🔐 Security & Environment ### Required Environment Variables ```bash GHL_API_KEY=your_private_integrations_api_key # Private Integrations API key (NOT regular API key) GHL_BASE_URL=https://services.leadconnectorhq.com GHL_LOCATION_ID=your_location_id # From Settings → Company → Locations NODE_ENV=production # Environment mode ``` ### Security Features - ✅ Environment-based configuration - ✅ Input validation and sanitization - ✅ Comprehensive error handling - ✅ CORS protection for web deployment - ✅ No sensitive data in code ## 🚨 Troubleshooting ### Common Issues **Build Failures:** ```bash npm run build # Check TypeScript compilation npm install # Ensure dependencies installed ``` **API Connection Issues:** - Verify Private Integrations API key is valid (not regular API key) - Check location ID is correct - Ensure required scopes are enabled in Private Integration - Ensure environment variables are set **ChatGPT Integration:** - Confirm SSE endpoint is accessible - Check CORS configuration - Verify MCP protocol compatibility ## 📊 Technical Stack - **Runtime**: Node.js 18+ with TypeScript - **Framework**: Express.js for HTTP server - **MCP SDK**: @modelcontextprotocol/sdk - **API Client**: Axios with interceptors - **Testing**: Jest with comprehensive coverage - **Deployment**: Vercel, Railway, Render, Docker ## 🤝 Contributing 1. Fork the repository 2. Create feature branch (`git checkout -b feature/amazing-feature`) 3. Commit changes (`git commit -m 'Add amazing feature'`) 4. Push to branch (`git push origin feature/amazing-feature`) 5. Open Pull Request ## 📝 License This project is licensed under the ISC License - see the [LICENSE](LICENSE) file for details. ## 🆘 Support - **Documentation**: Check the `/docs` folder - **Issues**: Open a GitHub issue - **API Docs**: GoHighLevel API documentation - **MCP Protocol**: Model Context Protocol specification ## 🎉 Success Story This server successfully connects ChatGPT to GoHighLevel with: - ✅ **21 operational tools** - ✅ **Real-time API integration** - ✅ **Production-ready deployment** - ✅ **Comprehensive error handling** - ✅ **Full TypeScript support** **Ready to automate your GoHighLevel workflows through ChatGPT!** 🚀 --- Made with ❤️ for the GoHighLevel community