MCP.Market

Ghl MCP server

by northrosetech·io.github.northrosetech/ghl-mcp-server·v1.0.1·1 stars
No reviews yet

GoHighLevel CRM for AI agents. 60+ tools for contacts, messaging, calendars, and payments.

B72/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
New

1 stars38 downloads/wk

Reviews

Write one

Nobody has reviewed Ghl yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Ghl tools (64, 27 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • ghl_add_contact_tags

    Add one or more tags to a contact.

  • ghl_add_contact_to_workflow

    Add a contact to a GHL workflow/automation.

  • ghl_cancel_scheduled_messagewrite action

    Cancel a previously scheduled message.

  • ghl_create_calendarwrite action

    Create a new calendar in GoHighLevel.

  • ghl_create_contactwrite action

    Create a new contact in GoHighLevel. Args: - firstName, lastName, email, phone (strings): Basic contact info - tags (string[]): Tags to apply - source (string): Lead source - customFields (array): Custom field values as [{id, field_value}] - locationId (string): Location ID (uses default if omitted) Returns: Created contact object with ID.

  • ghl_create_contact_notewrite action

    Add a note to a contact.

  • ghl_create_contact_taskwrite action

    Create a task for a contact.

  • ghl_create_custom_fieldwrite action

    Create a new custom field for contacts.

  • ghl_create_eventwrite action

    Create a new appointment/event on a GHL calendar.

  • ghl_create_invoicewrite action

    Create a new invoice for a contact.

  • ghl_create_location_tagwrite action

    Create a new tag in the location.

  • ghl_create_opportunitywrite action

    Create a new opportunity/deal in a pipeline.

  • ghl_create_social_postwrite action

    Schedule or publish a social media post.

  • ghl_delete_contactwrite action

    Permanently delete a contact. This cannot be undone.

  • ghl_delete_contact_notewrite action

    Delete a specific note from a contact.

  • ghl_delete_eventwrite action

    Delete/cancel an appointment.

  • ghl_delete_opportunitywrite action

    Permanently delete an opportunity.

  • ghl_get_calendar

    Get details of a specific calendar.

  • ghl_get_contact

    Get a single contact by ID with all details including custom fields, tags, and activity.

  • ghl_get_contact_notes

    Get all notes for a contact.

  • ghl_get_contact_tasks

    Get all tasks for a contact.

  • ghl_get_conversation

    Get a single conversation by ID with metadata.

  • ghl_get_events

    Get appointments/events for a location, optionally filtered by calendar, contact, or date range.

  • ghl_get_form_submissions

    Get submissions for forms in a location.

  • ghl_get_free_slots

    Get available booking slots for a calendar within a date range.

  • ghl_get_invoice

    Get details of a specific invoice.

  • ghl_get_location

    Get details of a GHL location/sub-account including settings, address, and configuration.

  • ghl_get_location_tags

    Get all tags defined in a location.

  • ghl_get_messages

    Get messages in a conversation thread. Returns SMS, email, and other message types.

  • ghl_get_opportunity

    Get details of a specific opportunity/deal.

  • ghl_get_orderwrite action

    Get details of a specific payment order.

  • ghl_list_blogs

    Get all blogs for a location.

  • ghl_list_calendars

    Get all calendars for the location.

  • ghl_list_campaigns

    Get all campaigns for a location.

  • ghl_list_custom_fields

    Get all custom fields for contacts in a location.

  • ghl_list_forms

    Get all forms for a location.

  • ghl_list_funnels

    Get all funnels/websites for a location.

  • ghl_list_invoices

    Get invoices for a location. Filter by status, contact, or date range.

  • ghl_list_links

    Get all trigger links for a location.

  • ghl_list_orders

    Get payment orders for a location.

  • ghl_list_pipelines

    Get all pipelines and their stages for a location.

  • ghl_list_products

    Get all products for a location.

  • ghl_list_social_accounts

    Get all connected social media accounts (Facebook, Instagram, Google, etc.).

  • ghl_list_social_posts

    Get scheduled and published social media posts.

  • ghl_list_subscriptions

    Get active subscriptions for a location.

  • ghl_list_surveys

    Get all surveys for a location.

  • ghl_list_transactions

    Get payment transactions for a location.

  • ghl_list_workflows

    Get all workflows/automations for a location.

  • ghl_remove_contact_from_workflowwrite action

    Remove a contact from a GHL workflow.

  • ghl_remove_contact_tagswrite action

    Remove one or more tags from a contact.

  • ghl_search_contacts

    Search contacts in GoHighLevel by query, tags, filters, or custom fields. Returns paginated results. Args: - query (string): Search term (name, email, phone) - locationId (string): Location ID (uses default if omitted) - limit (number): Results per page (1-100, default 20) - filters (object): Advanced filters like tags, date ranges, custom fields Returns: List of contacts with pagination metadata.

  • ghl_search_conversations

    Search conversations by contact ID, query, or status. Returns threaded conversations with latest message info.

  • ghl_search_opportunities

    Search opportunities (deals) by pipeline, stage, status, contact, or monetary value.

  • ghl_search_users

    Search for users/team members in a location.

  • ghl_send_invoicewrite action

    Send an invoice to the contact via email.

  • ghl_send_messagewrite action

    Send a message (SMS, Email, WhatsApp, or other) to a contact via GoHighLevel. Args: - type: "SMS", "Email", "WhatsApp", "GMB", "IG", "FB", "Custom", "Live_Chat" - contactId: The recipient contact ID - message: The message body (text for SMS/WhatsApp, HTML for email) - subject: Email subject (required for Email type) - emailFrom: Sender email (for Email type) - html: HTML body (for Email type, alte

  • ghl_update_contactwrite action

    Update an existing contact. Only pass fields you want to change.

  • ghl_update_contact_taskwrite action

    Update an existing task for a contact.

  • ghl_update_conversationwrite action

    Update conversation status (starred, unread, etc.).

  • ghl_update_eventwrite action

    Update an existing appointment/event.

  • ghl_update_opportunitywrite action

    Update an existing opportunity — move stages, change value, update status, etc.

  • ghl_update_opportunity_statuswrite action

    Change the status of an opportunity (open, won, lost, abandoned).

  • ghl_upsert_contactwrite action

    Create or update a contact by email/phone. If a match is found, updates; otherwise creates new.

  • ghl_void_invoice

    Void an existing invoice.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan21 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 158 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Ghl compares

Against every graded Sales and outbound MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
72/100
higher than 40% of 876 Sales and outbound servers
Tools
64
the typical Sales and outbound server has 8
Tools that change things
42%
typical: 11%. Fewer write tools means less an agent can break
GitHub stars
1
more than 70% of 420 Sales and outbound servers
Downloads a week
38
more than 30% of 156 Sales and outbound servers with a package

What its tools let an agent do: 37 read · 27 change

Install Ghl in Claude Code, Cursor or VS Code

Runs npx -y @northrosetech/ghl-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add ghl-mcp-server -- npx -y @northrosetech/ghl-mcp-server
Add to Cursor

What the publisher says

From the Ghl repository's README, as published. We do not edit it. Read it on GitHub

GHL MCP Server

GoHighLevel MCP Server for Claude, N8N, and Custom AI Agents

Built by Saurabh K Shah (https://saurabhshah.com)

A comprehensive Model Context Protocol (MCP) server that connects AI assistants directly to your GoHighLevel CRM. Supports 60+ tools across contacts, conversations, calendars, pipelines, payments, invoices, workflows, custom fields, social media, and more.

Features

  • Contacts: Search, create, update, delete, upsert, tags, notes, tasks, workflow management
  • Conversations & Messaging: SMS, Email, WhatsApp, search threads, send messages, schedule sends
  • Calendars & Appointments: List calendars, get free slots, create/update/delete events
  • Opportunities & Pipelines: Full deal management, stage transitions, pipeline listing
  • Payments & Invoices: Orders, transactions, subscriptions, create/send/void invoices
  • Workflows: List all workflows, add/remove contacts from workflows
  • Custom Fields: List, create custom fields for contacts
  • Locations: Sub-account details, tags management
  • Users: Search team members
  • Forms & Surveys: List forms/surveys, get submissions
  • Campaigns: List all campaigns
  • Social Media: List/create posts, view connected accounts

Quick Start

1. Get Your GHL Credentials

  1. Log into GoHighLevel → Settings → Private Integrations
  2. Click Create New Integration
  3. Name it (e.g., "Claude MCP Server")
  4. Select all scopes you need (contacts, conversations, calendars, payments, etc.)
  5. Copy the Private Integration Token
  6. Note your Location ID (visible in the URL when viewing any sub-account)

2. Install & Configure

git clone https://github.com/northrosetech/ghl-mcp-server.git
cd ghl-mcp-server
npm install
cp .env.example .env

Edit .env:

GHL_API_KEY=your_private_integration_token_here
GHL_LOCATION_ID=your_location_id_here

Build:

npm run build

3. Connect to Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claudedesktopconfig.json on Mac):

{
  "mcpServers": {
    "ghl": {
      "command": "node",
      "args": ["/absolute/path/to/ghl-mcp-server/dist/index.js"],
      "env": {
        "GHL_API_KEY": "your_private_integration_token",
        "GHL_LOCATION_ID": "your_location_id",
        "TRANSPORT": "stdio"
      }
    }
  }
}

Restart Claude Desktop. You should see GHL tools available.

4. Connect to N8N (HTTP Mode)

Start the server in HTTP mode:

TRANSPORT=http PORT=3001 GHL_API_KEY=your_token GHL_LOCATION_ID=your_id node dist/index.js

In N8N:

  1. Add an MCP Client node
  2. Set URL to http://localhost:3001/mcp
  3. Set transport to HTTP Streamable
  4. Use the GHL tools in your workflows

5. Connect to Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "ghl": {
      "command": "node",
      "args": ["./ghl-mcp-server/dist/index.js"],
      "env": {
        "GHL_API_KEY": "your_token",
        "GHL_LOCATION_ID": "your_id"
      }
    }
  }
}

Available Tools (60+)

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Ghl: common questions

Is Ghl MCP server safe?
Mostly: it is graded B (72/100). Read the Ghl safety report
How do I install Ghl?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Ghl need an API key?
Yes. The registry entry asks for GHL_API_KEY.
Is Ghl maintained?
The last commit was 195 days ago (2026-04-23). The latest release is v1.0.1.
What can I use instead of Ghl?
Servers from other publishers that do the same job: Conduyt CRM MCP server, Customermates MCP server and Salesforce MCP server.
How does Ghl compare with other Sales and outbound MCP servers?
safety score 72/100 (higher than 40% of 876 Sales and outbound servers); tools 64 (the typical Sales and outbound server has 8); tools that change things 42% (typical: 11%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Ghl

Same job from other publishers: the closest match first, then the best rated.

  • Conduyt CRM
    Conduyt CRM tools for AI agents: contacts, deals, pipelines, tasks, automations, messaging, reports
    B
  • Customermates
    Native MCP access to CRM contacts, organizations, deals and tasks with user permissions.
    A
  • Salesforce
    Salesforce CRM MCP server: accounts, contacts, opportunities, leads, tasks, and custom objects
    More from mindstone →
    A
  • Pipedrive
    Complete Pipedrive CRM integration with 254 MCP tools for deals, contacts, and pipelines
    B
  • Pinlyx
    Pinlyx CRM for AI assistants: contacts, deals, social inbox and posts, email and Google Ads.
    A