Ghl MCP Server
概要
作者による説明(英語の原文)
GoHighLevel CRM for AI agents. 60+ tools for contacts, messaging, calendars, and payments.
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況iとても新しい↓ 35/週 · ★ –
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: パソコンで動く
- トランスポート: stdio
- カテゴリ: マーケティング・SNS
- 入力が必要なもの:GHL_API_KEY, GHL_LOCATION_ID
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック:1項目中1項目に合格
- あなたのパソコンで、あなたのユーザーと同じ権限(ファイル、ネットワーク、アプリ)で動きます。
- 自分で入力するもの:
GHL_API_KEY,GHL_LOCATION_ID,GHL_BASE_URL,GHL_API_VERSION,TRANSPORT,LOG_LEVEL
「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
- npmNode.jsのインストール(npxコマンドに必要)
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"ghl": {
"command": "npx",
"args": [
"-y",
"@northrosetech/ghl-mcp-server"
],
"env": {
"GHL_API_KEY": "your-value",
"GHL_LOCATION_ID": "your-value",
"GHL_BASE_URL": "your-value",
"GHL_API_VERSION": "your-value",
"TRANSPORT": "your-value",
"LOG_LEVEL": "your-value"
}
}
}
}ターミナルでこれを実行します
claude mcp add ghl --env GHL_API_KEY=your-value --env GHL_LOCATION_ID=your-value --env GHL_BASE_URL=your-value --env GHL_API_VERSION=your-value --env TRANSPORT=your-value --env LOG_LEVEL=your-value -- npx -y @northrosetech/ghl-mcp-server動かす前に、空欄の値を入力してください。
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"ghl": {
"command": "npx",
"args": [
"-y",
"@northrosetech/ghl-mcp-server"
],
"env": {
"GHL_API_KEY": "your-value",
"GHL_LOCATION_ID": "your-value",
"GHL_BASE_URL": "your-value",
"GHL_API_VERSION": "your-value",
"TRANSPORT": "your-value",
"LOG_LEVEL": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"ghl": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@northrosetech/ghl-mcp-server"
],
"env": {
"GHL_API_KEY": "your-value",
"GHL_LOCATION_ID": "your-value",
"GHL_BASE_URL": "your-value",
"GHL_API_VERSION": "your-value",
"TRANSPORT": "your-value",
"LOG_LEVEL": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
自分で入力する値
- GoHighLevel Private Integration Token. Create at: GHL Settings → Private Integrations → Create New Integration.
- GoHighLevel sub-account (location) ID. Visible in the URL when viewing a sub-account.
GHL_BASE_URLenvGHL API base URL. The default works for all standard installs.GHL_API_VERSIONenvValue for the GHL API Version header.TRANSPORTenvTransport mode: 'stdio' for Claude Desktop / Claude Code, 'http' for N8N and remote clients.LOG_LEVELenvLog verbosity.
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月9日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント northrosetech で確認済みです
- … 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
マーケティング・SNSのほかのサーバーとの比較i
- このカテゴリのほかの3632件のうち0%よりスターが多い
- このカテゴリのほかの3632件のうち6%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの3632件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Ghl MCP Serverは安全ですか?
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:GHL_API_KEY, GHL_LOCATION_ID
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は–、最新バージョン(1.0.1)がレジストリに届いたのは7 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは?
同じカテゴリには:MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Google Analytics MCP
GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
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)