Mindflowed

You can run an MCP server that connects Claude Desktop or other MCP clients to your GoHighLevel account, enabling AI-powered automation across contacts, calendar events, opportunities, messages, and more. This server exposes a wide set of tools that you can invoke from your MCP client to read, write, and orchestrate your GHL data with AI workflows.

How to use

You will run an MCP client against two entry points: a remote HTTP MCP endpoint or a local stdio MCP server. Use the HTTP endpoint when your client communicates over the network to a deployed instance, and use the stdio setup when you run the MCP server locally and your client talks to it via standard input/output.

Practical usage patterns include: creating or updating contacts and opportunities, scheduling appointments, sending messages, and running automated workflows. You can query data from your GoHighLevel account, trigger actions from natural language prompts, and compose multi-step sequences that the MCP server will execute through its tool catalog. Always ensure your API key and location are correctly configured, and respect API rate limits by batching or throttling requests.

How to install

# Prerequisites
nodejs_version="18" # or higher

# Clone the MCP server repository
git clone https://github.com/mindflowedstudios/mindflowed_mcp.git
cd mindflowed_mcp

# Install dependencies
npm install

# Create and configure environment
cp .env.example .env
# Edit .env to set GoHighLevel credentials and deployment settings

# Build the project
npm run build

# Start the server (production)
npm start

# Optional: development with hot reload
npm run dev

Configuration and security notes

You must provide a private Integrations API key from GoHighLevel, not a regular API key. This key, plus your Location ID, are required for the MCP server to access sub-account data. Store these values securely in your environment and do not commit them to version control.

Environment variables you should set include GHL_API_KEY, GHL_BASE_URL, GHL_LOCATION_ID, and NODE_ENV. Optional variables like PORT and CORS origins help tailor the deployment to your environment.

Available tools

create_contact

Create a new contact in GoHighLevel with associated metadata and tags.

update_contact

Update an existing contact's fields, tags, or relationships.

get_contact

Fetch a contact by ID or unique identifier.

search_contacts

Search contacts using filters like tags, status, or custom fields.

create_opportunity

Create a new sales opportunity linked to a contact or account.

update_opportunity

Modify opportunity fields such as stage, value, or close date.

get_opportunity

Retrieve an opportunity by ID.

create_appointment

Schedule a calendar event or appointment in the connected calendar.

get_calendar_events

List calendar events for a specific date range.

send_sms

Send an SMS message to a contact or group.

send_email

Dispatch an email with optional templates and rich formatting.

create_blog_post

Create a new blog post and publish or draft it in the connected CMS.

get_invoice

Retrieve invoice details for a given invoice ID.

create_invoice

Create a new invoice and link it to a customer or opportunity.

verify_email

Perform deliverability check and risk assessment for an email address.

ghl_get_all_associations

Fetch all object associations between records.

ghl_create_association

Create a relationship between two records.

ghl_get_workflows

Discover available automation workflows.