GoHighLevel MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "GHL_API_KEY=${GHL_API_KEY}" -e "GHL_LOCATION_ID=${GHL_LOCATION_ID}" gohighlevel-mcp -- npx -y @thinkbedo/gohighlevel-mcp
Required:GHL_API_KEYGHL_LOCATION_ID
README.md

Transform Claude Desktop into a complete GoHighLevel CRM powerhouse

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:

  1. Login to your GoHighLevel account

  2. Navigate to SettingsIntegrationsPrivate 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

Tools (3)

contact_managementTools for managing contacts, tasks, notes, and relationships.
messaging_toolsTools for SMS, email, conversations, and call recordings.
business_operationsTools for location management, custom objects, workflows, and surveys.

Environment Variables

GHL_API_KEYrequiredPrivate Integrations API key from GoHighLevel settings
GHL_LOCATION_IDrequiredThe Location ID for your specific sub-account

Configuration

claude_desktop_config.json
{"mcpServers": {"gohighlevel": {"command": "npx", "args": ["-y", "@thinkbedo/gohighlevel-mcp"], "env": {"GHL_API_KEY": "your_private_integration_key", "GHL_LOCATION_ID": "your_location_id"}}}}

Try it

Find the contact details for John Doe and list his recent notes.
Send an SMS to the latest lead in my pipeline asking about their interest in our services.
List all active opportunities in the sales pipeline for this month.
Create a new task for the sales team to follow up with the contact associated with conversation ID 12345.
Retrieve the latest call recording for the conversation with Sarah Smith.

Frequently Asked Questions

What are the key features of GoHighLevel MCP Server?

Access to over 260 GoHighLevel API endpoints via MCP. Comprehensive contact management including tasks and notes. Advanced messaging capabilities for SMS, email, and call recordings. Business operations support for workflows, surveys, and custom objects. Full sub-account level API integration.

What can I use GoHighLevel MCP Server for?

Automating follow-up tasks for new leads captured in GoHighLevel. Summarizing recent conversation history with clients directly in Claude. Managing sales pipeline opportunities through natural language commands. Streamlining CRM data entry by updating contact records via AI.

How do I install GoHighLevel MCP Server?

Install GoHighLevel MCP Server by running: npx -y @thinkbedo/gohighlevel-mcp

What MCP clients work with GoHighLevel MCP Server?

GoHighLevel MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep GoHighLevel MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare