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:

1. Login to your GoHighLevel account

2. Navigate to Settings Integrations Private Integrations

3. Create New Private Integration:

   • Name: MCP Server Integration (or your preferred name)
   • Webhook URL: Leave blank (not needed)

4. 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

5. Save Integration and copy the generated Private API Key

6. 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
• ** Sales & Revenue**: Opportunities, payments, invoices, estimates, and billing automation
• ** Marketing Automation**: Social media, email campaigns, blog management, and media library
• ** E-commerce**: Store management, products, inventory, shipping, and order fulfillment

Quick Deploy Options

Vercel (Recommended)

Why Vercel:

• Free tier with generous limits
• Automatic HTTPS and global CDN
• Zero-config deployment
• Perfect for MCP servers

Railway

Why Railway:

• $5 free monthly credit
• Simple one-click deployment
• Automatic scaling
• Great for production workloads

Render

• Free tier available
• Auto-deploy from GitHub
• Built-in SSL

Complete Tool Catalog (269 Tools)

Contact Management (31 Tools)

Core Operations:

• create_contact, search_contacts, get_contact, update_contact, delete_contact
• add_contact_tags, remove_contact_tags - Organize with tags

Task & Note Management:…