io.github.northrosetech/ghl-mcp-server

NPM · @NORTHROSETECH/GHL-MCP-SERVER · SCANNED AUG 6

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

Available components

+23 this week 67 67 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Known CVEs were checked across the 122 of 124 dependencies we could resolve, so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Dependency health was assessed across the 122 of 124 dependencies we could resolve, so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 104 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability66

AI-judged instruction clarity (good).Pass
Tool/resource definitions use about 3766 tokens (~58/item across 64 items; 64 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management33

Stability observed for 10 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage84

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
51% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @northrosetech/ghl-mcp-server

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add northrosetech-ghl-mcp-server -- npx -y @northrosetech/ghl-mcp-server

# add to Codex CLI

codex mcp add northrosetech-ghl-mcp-server -- npx -y @northrosetech/ghl-mcp-server

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "northrosetech-ghl-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@northrosetech/ghl-mcp-server"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add northrosetech-ghl-mcp-server --command npx --arg -y --arg @northrosetech/ghl-mcp-server

# ~/.hermes/config.yaml

mcp_servers:
  northrosetech-ghl-mcp-server:
    command: "npx"
    args: ["-y", "@northrosetech/ghl-mcp-server"]

// mcp.json

{
  "mcpServers": {
    "northrosetech-ghl-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@northrosetech/ghl-mcp-server"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

6 Aug 26 +1
- Security disclosure: unverified → fail ▼ functional
5 Aug 26 +1
- CVE-2026-69207 no longer affects this package ▲ security
- Known CVEs: fail → partial ▲ security
- Security disclosure: fail → unverified ▼ functional
4 Aug 26 0
- CVE-2026-69207 affects this package: medium ▼ security
- Known CVEs: partial → fail ▼ security
2 Aug 26 +46
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Stability: unverified → 0.20 ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Schema quality: unverified → good ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
1 Aug 26 −7
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 44

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 6 Aug 2026 · Analysed npm/@northrosetech/[email protected]

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result	No attestation
Ecosystem	npm

Dependencies 122 packages

Packages resolved	122
Deprecated	122
Stale	35
Tree resolution	Partial

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 64 exposed · ~3,766 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

ghl_add_contact_tags Add Tags to Contact ~39

Add one or more tags to a contact.

Input Output Examples

Name	Type	Req	Description
contactId	string	yes	Contact ID
tags	array	yes	Tags to add

No output schema declared.

No examples provided.

ghl_add_contact_to_workflow Add Contact to Workflow ~47

Add a contact to a GHL workflow/automation.

Input Output Examples

Name	Type	Req	Description
contactId	string	yes	Contact ID
workflowId	string	yes	Workflow ID to add contact to

No output schema declared.

No examples provided.

ghl_cancel_scheduled_message Cancel Scheduled Message ~29

Cancel a previously scheduled message.

Input Output Examples

Name	Type	Req	Description
messageId	string	yes	Message ID to cancel

No output schema declared.

No examples provided.

ghl_create_calendar Create GHL Calendar ~62

Create a new calendar in GoHighLevel.

Input Output Examples

Name	Type	Req	Description
calendarType	string	—	—
description	string	—	—
locationId	string	—	—
name	string	yes	Calendar name
slug	string	—	URL slug for booking page

No output schema declared.

No examples provided.

ghl_create_contact Create GHL Contact ~265

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.

Input Output Examples

Name	Type	Req	Description
address1	string	—	—
city	string	—	—
companyName	string	—	Company name
country	string	—	—
customFields	array	—	Custom field values
dnd	boolean	—	Do Not Disturb flag
email	string	—	Email address
firstName	string	—	First name
lastName	string	—	Last name
locationId	string	—	—
name	string	—	Full name (alternative to first/last)
phone	string	—	Phone number with country code
postalCode	string	—	—
source	string	—	Lead source
state	string	—	—
tags	array	—	Tags to apply
timezone	string	—	—
website	string	—	—

No output schema declared.

No examples provided.

ghl_create_contact_note Create Contact Note ~50

Add a note to a contact.

Input Output Examples

Name	Type	Req	Description
body	string	yes	Note content
contactId	string	yes	Contact ID
userId	string	—	User ID who created the note

No output schema declared.

No examples provided.

ghl_create_contact_task Create Contact Task ~81

Create a task for a contact.

Input Output Examples

Name	Type	Req	Description
assignedTo	string	—	User ID to assign task to
body	string	—	Task description
completed	boolean	—	—
contactId	string	yes	Contact ID
dueDate	string	—	Due date (ISO 8601)
title	string	yes	Task title

No output schema declared.

No examples provided.

ghl_create_custom_field Create Custom Field ~70

Create a new custom field for contacts.

Input Output Examples

Name	Type	Req	Description
dataType	string	yes	Field data type
locationId	string	—	—
name	string	yes	Field display name
options	array	—	Options for SINGLE_OPTIONS or MULTIPLE_OPTIONS type
placeholder	string	—	—

No output schema declared.

No examples provided.

ghl_create_event Create Calendar Event ~134

Create a new appointment/event on a GHL calendar.

Input Output Examples

Name	Type	Req	Description
address	string	—	Meeting address
appointmentStatus	string	—	—
assignedUserId	string	—	Assigned team member
calendarId	string	yes	Calendar ID
contactId	string	yes	Contact to book for
endTime	string	yes	Event end (ISO 8601)
locationId	string	—	—
notes	string	—	Internal notes
startTime	string	yes	Event start (ISO 8601)
status	string	—	—
title	string	—	Event title

No output schema declared.

No examples provided.

ghl_create_invoice Create Invoice ~76

Create a new invoice for a contact.

Input Output Examples

Name	Type	Req	Description
contactId	string	yes	Contact to invoice
currency	string	—	—
dueDate	string	—	Due date (ISO 8601)
items	array	yes	Line items
locationId	string	—	—
name	string	yes	Invoice title

No output schema declared.

No examples provided.

ghl_create_location_tag Create Location Tag ~35

Create a new tag in the location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—
name	string	yes	Tag name

No output schema declared.

No examples provided.

ghl_create_opportunity Create GHL Opportunity ~126

Create a new opportunity/deal in a pipeline.

Input Output Examples

Name	Type	Req	Description
assignedTo	string	—	Assigned user ID
contactId	string	yes	Contact ID to associate
customFields	array	—	—
locationId	string	—	—
monetaryValue	number	—	Deal value in currency
name	string	yes	Opportunity/deal name
pipelineId	string	yes	Pipeline ID to create opportunity in
pipelineStageId	string	yes	Stage ID within the pipeline
source	string	—	Lead source
status	string	—	—

No output schema declared.

No examples provided.

ghl_create_social_post Create Social Media Post ~83

Schedule or publish a social media post.

Input Output Examples

Name	Type	Req	Description
accountIds	array	yes	Social account IDs to post to
content	string	yes	Post content/caption
locationId	string	—	—
mediaUrls	array	—	Media file URLs
scheduledDate	string	—	Schedule date (ISO 8601) — omit for immediate publish

No output schema declared.

No examples provided.

ghl_delete_contact Delete GHL Contact ~32

Permanently delete a contact. This cannot be undone.

Input Output Examples

Name	Type	Req	Description
contactId	string	yes	Contact ID to delete

No output schema declared.

No examples provided.

ghl_delete_contact_note Delete Contact Note ~40

Delete a specific note from a contact.

Input Output Examples

Name	Type	Req	Description
contactId	string	yes	Contact ID
noteId	string	yes	Note ID to delete

No output schema declared.

No examples provided.

ghl_delete_event Delete Calendar Event ~27

Delete/cancel an appointment.

Input Output Examples

Name	Type	Req	Description
eventId	string	yes	Event ID to delete

No output schema declared.

No examples provided.

ghl_delete_opportunity Delete GHL Opportunity ~28

Permanently delete an opportunity.

Input Output Examples

Name	Type	Req	Description
opportunityId	string	yes	Opportunity ID to delete

No output schema declared.

No examples provided.

ghl_get_calendar Get GHL Calendar ~26

Get details of a specific calendar.

Input Output Examples

Name	Type	Req	Description
calendarId	string	yes	Calendar ID

No output schema declared.

No examples provided.

ghl_get_contact Get GHL Contact ~40

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

Input Output Examples

Name	Type	Req	Description
contactId	string	yes	The contact ID to retrieve

No output schema declared.

No examples provided.

ghl_get_contact_notes Get Contact Notes ~27

Get all notes for a contact.

Input Output Examples

Name	Type	Req	Description
contactId	string	yes	Contact ID

No output schema declared.

No examples provided.

ghl_get_contact_tasks Get Contact Tasks ~27

Get all tasks for a contact.

Input Output Examples

Name	Type	Req	Description
contactId	string	yes	Contact ID

No output schema declared.

No examples provided.

ghl_get_conversation Get GHL Conversation ~29

Get a single conversation by ID with metadata.

Input Output Examples

Name	Type	Req	Description
conversationId	string	yes	Conversation ID

No output schema declared.

No examples provided.

ghl_get_events Get Calendar Events ~105

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

Input Output Examples

Name	Type	Req	Description
calendarId	string	—	Filter by calendar ID
contactId	string	—	Filter by contact ID
endTime	string	—	End of date range (ISO 8601)
locationId	string	—	—
startTime	string	—	Start of date range (ISO 8601)
userId	string	—	Filter by assigned user

No output schema declared.

No examples provided.

ghl_get_form_submissions Get Form Submissions ~46

Get submissions for forms in a location.

Input Output Examples

Name	Type	Req	Description
formId	string	—	Filter by specific form
limit	integer	—	—
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_get_free_slots Get Calendar Free Slots ~94

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

Input Output Examples

Name	Type	Req	Description
calendarId	string	yes	Calendar ID
endDate	string	yes	End date (YYYY-MM-DD or ISO 8601)
startDate	string	yes	Start date (YYYY-MM-DD or ISO 8601)
timezone	string	—	Timezone (e.g., 'Asia/Kolkata', 'America/New_York')

No output schema declared.

No examples provided.

ghl_get_invoice Get Invoice ~24

Get details of a specific invoice.

Input Output Examples

Name	Type	Req	Description
invoiceId	string	yes	—

No output schema declared.

No examples provided.

ghl_get_location Get Location Details ~41

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

Input Output Examples

Name	Type	Req	Description
locationId	string	—	Location ID (uses default if omitted)

No output schema declared.

No examples provided.

ghl_get_location_tags Get Location Tags ~26

Get all tags defined in a location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_get_messages Get Conversation Messages ~59

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

Input Output Examples

Name	Type	Req	Description
conversationId	string	yes	Conversation ID
limit	integer	—	—
type	string	—	Message type filter: SMS, Email, etc.

No output schema declared.

No examples provided.

ghl_get_opportunity Get GHL Opportunity ~29

Get details of a specific opportunity/deal.

Input Output Examples

Name	Type	Req	Description
opportunityId	string	yes	Opportunity ID

No output schema declared.

No examples provided.

ghl_get_order Get Payment Order ~27

Get details of a specific payment order.

Input Output Examples

Name	Type	Req	Description
orderId	string	yes	Order ID

No output schema declared.

No examples provided.

ghl_list_blogs List Blogs ~25

Get all blogs for a location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_calendars List GHL Calendars ~26

Get all calendars for the location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_campaigns List Campaigns ~25

Get all campaigns for a location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_custom_fields List Custom Fields ~28

Get all custom fields for contacts in a location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_forms List Forms ~24

Get all forms for a location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_funnels List Funnels ~27

Get all funnels/websites for a location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_invoices List Invoices ~56

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

Input Output Examples

Name	Type	Req	Description
contactId	string	—	—
limit	integer	—	—
locationId	string	—	—
status	string	—	—

No output schema declared.

No examples provided.

ghl_list_links List Trigger Links ~25

Get all trigger links for a location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_orders List Payment Orders ~38

Get payment orders for a location.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	—
locationId	string	—	—
offset	integer	—	—

No output schema declared.

No examples provided.

ghl_list_pipelines List GHL Pipelines ~28

Get all pipelines and their stages for a location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_products List Products ~24

Get all products for a location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_social_accounts List Connected Social Accounts ~33

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

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_social_posts List Social Media Posts ~33

Get scheduled and published social media posts.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	—
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_subscriptions List Subscriptions ~32

Get active subscriptions for a location.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	—
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_surveys List Surveys ~25

Get all surveys for a location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_list_transactions List Transactions ~38

Get payment transactions for a location.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	—
locationId	string	—	—
offset	integer	—	—

No output schema declared.

No examples provided.

ghl_list_workflows List GHL Workflows ~28

Get all workflows/automations for a location.

Input Output Examples

Name	Type	Req	Description
locationId	string	—	—

No output schema declared.

No examples provided.

ghl_remove_contact_from_workflow Remove Contact from Workflow ~41

Remove a contact from a GHL workflow.

Input Output Examples

Name	Type	Req	Description
contactId	string	yes	Contact ID
workflowId	string	yes	Workflow ID

No output schema declared.

No examples provided.

ghl_remove_contact_tags Remove Tags from Contact ~39

Remove one or more tags from a contact.

Input Output Examples

Name	Type	Req	Description
contactId	string	yes	Contact ID
tags	array	yes	Tags to remove

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 6 Aug

Day	Score
27 Jul	44
28 Jul	44
29 Jul	44
31 Jul	26
1 Aug	19
2 Aug	65
3 Aug	65
4 Aug	65
5 Aug	66
6 Aug	67