Server data from the Official MCP Registry
GoHighLevel CRM for AI agents. 60+ tools for contacts, messaging, calendars, and payments.
GoHighLevel CRM for AI agents. 60+ tools for contacts, messaging, calendars, and payments.
This is a well-structured GoHighLevel MCP server with proper authentication, reasonable permissions, and good code quality. The server requires API key authentication via environment variables and follows MCP best practices. Minor issues include broad exception handling and some input validation gaps, but these do not pose security risks given the server's purpose as a CRM integration tool. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
4 files analyzed · 9 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: GHL_API_KEY
Environment variable: GHL_LOCATION_ID
Environment variable: GHL_BASE_URL
Environment variable: GHL_API_VERSION
Environment variable: TRANSPORT
Environment variable: LOG_LEVEL
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-northrosetech-ghl-mcp-server": {
"env": {
"LOG_LEVEL": "your-log-level-here",
"TRANSPORT": "your-transport-here",
"GHL_API_KEY": "your-ghl-api-key-here",
"GHL_BASE_URL": "your-ghl-base-url-here",
"GHL_API_VERSION": "your-ghl-api-version-here",
"GHL_LOCATION_ID": "your-ghl-location-id-here"
},
"args": [
"-y",
"@northrosetech/ghl-mcp-server"
],
"command": "npx"
}
}
}From the project's GitHub README.
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.
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
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.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.
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:
http://localhost:3001/mcpAdd 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"
}
}
}
}
| Tool | Description |
|---|---|
ghl_search_contacts | Search contacts by query, tags, filters |
ghl_get_contact | Get contact by ID |
ghl_create_contact | Create new contact |
ghl_update_contact | Update existing contact |
ghl_delete_contact | Delete contact |
ghl_upsert_contact | Create or update by email/phone |
ghl_add_contact_tags | Add tags to contact |
ghl_remove_contact_tags | Remove tags from contact |
ghl_get_contact_notes | Get contact notes |
ghl_create_contact_note | Add note to contact |
ghl_delete_contact_note | Delete a note |
ghl_get_contact_tasks | Get contact tasks |
ghl_create_contact_task | Create task for contact |
ghl_update_contact_task | Update task |
ghl_add_contact_to_workflow | Add contact to workflow |
ghl_remove_contact_from_workflow | Remove from workflow |
| Tool | Description |
|---|---|
ghl_search_conversations | Search conversation threads |
ghl_get_conversation | Get conversation details |
ghl_get_messages | Get messages in a thread |
ghl_send_message | Send SMS/Email/WhatsApp/etc. |
ghl_cancel_scheduled_message | Cancel scheduled message |
ghl_update_conversation | Update conversation status |
| Tool | Description |
|---|---|
ghl_list_calendars | List all calendars |
ghl_get_calendar | Get calendar details |
ghl_get_free_slots | Get available booking slots |
ghl_get_events | Get appointments/events |
ghl_create_event | Create appointment |
ghl_update_event | Update appointment |
ghl_delete_event | Delete appointment |
ghl_create_calendar | Create new calendar |
| Tool | Description |
|---|---|
ghl_search_opportunities | Search deals |
ghl_get_opportunity | Get deal details |
ghl_create_opportunity | Create new deal |
ghl_update_opportunity | Update deal / move stages |
ghl_delete_opportunity | Delete deal |
ghl_update_opportunity_status | Change deal status |
ghl_list_pipelines | List pipelines & stages |
| Tool | Description |
|---|---|
ghl_list_orders | List payment orders |
ghl_get_order | Get order details |
ghl_list_transactions | List transactions |
ghl_list_subscriptions | List subscriptions |
ghl_list_invoices | List invoices |
ghl_get_invoice | Get invoice details |
ghl_create_invoice | Create invoice |
ghl_send_invoice | Email invoice to contact |
ghl_void_invoice | Void an invoice |
| Tool | Description |
|---|---|
ghl_list_workflows | List all workflows |
ghl_list_custom_fields | List custom fields |
ghl_create_custom_field | Create custom field |
ghl_get_location | Get location details |
ghl_get_location_tags | Get location tags |
ghl_create_location_tag | Create new tag |
ghl_search_users | Search team members |
ghl_list_forms | List forms |
ghl_get_form_submissions | Get form submissions |
ghl_list_surveys | List surveys |
ghl_list_campaigns | List campaigns |
ghl_list_social_posts | List social posts |
ghl_create_social_post | Create/schedule social post |
ghl_list_social_accounts | List connected social accounts |
ghl_list_funnels | List funnels/websites |
ghl_list_products | List products |
ghl_list_blogs | List blogs |
ghl_list_links | List trigger links |
ghl-mcp-server/
├── src/
│ ├── index.ts # Entry point (stdio + HTTP transport)
│ ├── constants.ts # All GHL API endpoints & config
│ ├── types.ts # TypeScript interfaces
│ ├── services/
│ │ └── api-client.ts # Auth, rate limiting, error handling
│ └── tools/
│ ├── contacts.ts # Contact management tools
│ ├── conversations.ts # Messaging tools
│ ├── calendars.ts # Calendar & appointment tools
│ ├── opportunities.ts # Pipeline & deal tools
│ └── business.ts # Payments, invoices, workflows, etc.
├── dist/ # Compiled JS
├── package.json
├── tsconfig.json
└── .env.example
The server includes built-in rate limiting matching GHL's limits:
The server automatically queues and retries when limits are approached.
All tools return actionable error messages with hints:
MIT — Built by Saurabh K Shah (https://saurabhshah.com)
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.