Back to Browse
Free
Server data from the Official MCP Registry
GoHighLevel CRM for AI agents. 60+ tools for contacts, messaging, calendars, and payments.
About
GoHighLevel CRM for AI agents. 60+ tools for contacts, messaging, calendars, and payments.
Security Report
4.2
Use Caution4.2High RiskThis 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.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
GoHighLevel Private Integration Token. Create at: GHL Settings → Private Integrations → Create New Integration.Required
Environment variable: GHL_API_KEY
GoHighLevel sub-account (location) ID. Visible in the URL when viewing a sub-account.
Environment variable: GHL_LOCATION_ID
GHL API base URL. The default works for all standard installs.
Environment variable: GHL_BASE_URL
Value for the GHL API Version header.
Environment variable: GHL_API_VERSION
Transport mode: 'stdio' for Claude Desktop / Claude Code, 'http' for N8N and remote clients.
Environment variable: TRANSPORT
Log verbosity.
Environment variable: LOG_LEVEL
How to Install
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"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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
- Funnels & Blogs: List funnels, blogs
- Products: List products and prices
Quick Start
1. Get Your GHL Credentials
- Log into GoHighLevel → Settings → Private Integrations
- Click Create New Integration
- Name it (e.g., "Claude MCP Server")
- Select all scopes you need (contacts, conversations, calendars, payments, etc.)
- Copy the Private Integration Token
- 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/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.
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:
- Add an MCP Client node
- Set URL to
http://localhost:3001/mcp - Set transport to HTTP Streamable
- 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+)
Contacts (15 tools)
| 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 |
Conversations & Messaging (6 tools)
| 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 |
Calendars & Appointments (8 tools)
| 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 |
Opportunities & Pipelines (7 tools)
| 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 |
Payments & Invoices (9 tools)
| 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 |
Other Tools (15+ tools)
| 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 |
Architecture
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
Rate Limits
The server includes built-in rate limiting matching GHL's limits:
- Burst: 100 requests per 10 seconds
- Daily: 200,000 requests per day
The server automatically queues and retries when limits are approached.
Error Handling
All tools return actionable error messages with hints:
- 401: Check your API key (must be Private Integration Token)
- 403: Missing scopes — edit your Private Integration in GHL Settings
- 404: Resource not found — check the ID
- 422: Validation error with details
- 429: Rate limit — automatic retry
License
MIT — Built by Saurabh K Shah (https://saurabhshah.com)
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
3
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
404
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
55
Installs
10.0
Security
5.0
Local