ghl-mcp-server

GHL MCP サーバー

Claude、N8N、カスタム AI エージェント向け GoHighLevel MCP サーバー Saurabh K Shah が開発（https://saurabhshah.com）

AI アシスタントを GoHighLevel CRM に直接接続する、包括的な Model Context Protocol（MCP）サーバーです。連絡先、会話、カレンダー、パイプライン、支払い、請求書、ワークフロー、カスタムフィールド、ソーシャルメディアなどに対応する60 種類以上のツールをサポートしています。

機能

• 連絡先：検索、作成、更新、削除、作成または更新、タグ、メモ、タスク、ワークフロー管理
• 会話とメッセージング：SMS、メール、WhatsApp、スレッド検索、メッセージ送信、送信予約
• カレンダーと予約：カレンダー一覧、空き時間の取得、イベントの作成／更新／削除
• 商談とパイプライン：商談の完全な管理、ステージの移動、パイプライン一覧
• 支払いと請求書：注文、取引、サブスクリプション、請求書の作成／送信／無効化
• ワークフロー：すべてのワークフローの一覧表示、ワークフローへの連絡先の追加／削除
• カスタムフィールド：連絡先用カスタムフィールドの一覧表示、作成
• ロケーション：サブアカウントの詳細、タグ管理
• ユーザー：チームメンバーの検索
• フォームとアンケート：フォーム／アンケートの一覧表示、送信内容の取得
• キャンペーン：すべてのキャンペーンの一覧表示
• ソーシャルメディア：投稿の一覧表示／作成、接続済みアカウントの表示
• ファネルとブログ：ファネル、ブログの一覧表示
• 製品：製品と価格の一覧表示

クイックスタート

1. GHL の認証情報を取得する

1. GoHighLevel にログインし、Settings → Private Integrations の順に選択します
2. Create New Integration をクリックします
3. 名前を付けます（例：「Claude MCP Server」）
4. 必要なスコープ（連絡先、会話、カレンダー、支払いなど）をすべて選択します
5. Private Integration Token をコピーします
6. Location ID を確認します（任意のサブアカウントを表示したときの URL に表示されます）

2. インストールと設定

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

.env を編集します：

GHL_API_KEY=your_private_integration_token_here
GHL_LOCATION_ID=your_location_id_here

ビルドします：

npm run build

3. Claude Desktop に接続する

Claude Desktop の設定ファイルに追加します（Mac の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "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"
      }
    }
  }
}

Claude Desktop を再起動します。GHL ツールが利用可能になります。

4. N8N に接続する（HTTP モード）

HTTP モードでサーバーを起動します：

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

N8N で：

1. MCP Client ノードを追加します
2. URL に http://localhost:3001/mcp を設定します
3. トランスポートに HTTP Streamable を設定します
4. ワークフローで GHL ツールを使用します

5. Claude Code に接続する

プロジェクトの .mcp.json に追加します：

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

利用可能なツール（60 種類以上）

連絡先（15 ツール）

ツール	説明
ghl_search_contacts	クエリ、タグ、フィルターで連絡先を検索
ghl_get_contact	ID で連絡先を取得
ghl_create_contact	新しい連絡先を作成
ghl_update_contact	既存の連絡先を更新
ghl_delete_contact	連絡先を削除
ghl_upsert_contact	メールアドレス／電話番号を基に作成または更新
ghl_add_contact_tags	連絡先にタグを追加
ghl_remove_contact_tags	連絡先からタグを削除
ghl_get_contact_notes	連絡先のメモを取得
ghl_create_contact_note	連絡先にメモを追加
ghl_delete_contact_note	メモを削除
ghl_get_contact_tasks	連絡先のタスクを取得
ghl_create_contact_task	連絡先のタスクを作成
ghl_update_contact_task	タスクを更新
ghl_add_contact_to_workflow	ワークフローに連絡先を追加
ghl_remove_contact_from_workflow	ワークフローから連絡先を削除

会話とメッセージング（6 ツール）

ツール	説明
ghl_search_conversations	会話スレッドを検索
ghl_get_conversation	会話の詳細を取得
ghl_get_messages	スレッド内のメッセージを取得
ghl_send_message	SMS／メール／WhatsApp などを送信
ghl_cancel_scheduled_message	予約済みメッセージをキャンセル
ghl_update_conversation	会話のステータスを更新

カレンダーと予約（8 ツール）

ツール	説明
ghl_list_calendars	すべてのカレンダーを一覧表示
ghl_get_calendar	カレンダーの詳細を取得
ghl_get_free_slots	予約可能な時間枠を取得
ghl_get_events	予約／イベントを取得
ghl_create_event	予約を作成
ghl_update_event	予約を更新
ghl_delete_event	予約を削除
ghl_create_calendar	新しいカレンダーを作成

商談とパイプライン（7 ツール）

ツール	説明
ghl_search_opportunities	商談を検索
ghl_get_opportunity	商談の詳細を取得
ghl_create_opportunity	新しい商談を作成
ghl_update_opportunity	商談を更新／ステージを移動
ghl_delete_opportunity	商談を削除
ghl_update_opportunity_status	商談のステータスを変更
ghl_list_pipelines	パイプラインとステージを一覧表示

支払いと請求書（9 ツール）

ツール	説明
ghl_list_orders	支払い注文を一覧表示
ghl_get_order	注文の詳細を取得
ghl_list_transactions	取引を一覧表示
ghl_list_subscriptions	サブスクリプションを一覧表示
ghl_list_invoices	請求書を一覧表示
ghl_get_invoice	請求書の詳細を取得
ghl_create_invoice	請求書を作成
ghl_send_invoice	請求書を連絡先にメールで送信
ghl_void_invoice	請求書を無効化

その他のツール（15 以上のツール）

ツール	説明
ghl_list_workflows	すべてのワークフローを一覧表示
ghl_list_custom_fields	カスタムフィールドを一覧表示
ghl_create_custom_field	カスタムフィールドを作成
ghl_get_location	ロケーションの詳細を取得
ghl_get_location_tags	ロケーションのタグを取得
ghl_create_location_tag	新しいタグを作成
ghl_search_users	チームメンバーを検索
ghl_list_forms	フォームを一覧表示
ghl_get_form_submissions	フォームの送信内容を取得
ghl_list_surveys	アンケートを一覧表示
ghl_list_campaigns	キャンペーンを一覧表示
ghl_list_social_posts	ソーシャル投稿を一覧表示
ghl_create_social_post	ソーシャル投稿を作成／予約
ghl_list_social_accounts	接続済みのソーシャルアカウントを一覧表示
ghl_list_funnels	ファネル／ウェブサイトを一覧表示
ghl_list_products	商品を一覧表示
ghl_list_blogs	ブログを一覧表示
ghl_list_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

レート制限

このサーバーには、GHL の制限に準拠したレート制限機能が組み込まれています。

• バースト：10 秒あたり 100 件のリクエスト
• 1 日あたり：1 日あたり 200,000 件のリクエスト

制限に近づくと、サーバーはリクエストを自動的にキューに入れて再試行します。

エラー処理

すべてのツールは、ヒントを含む実行可能なエラーメッセージを返します。

• 401：API キーを確認してください（Private Integration Token が必要です）
• 403：スコープが不足しています — GHL の Settings で Private Integration を編集してください
• 404：リソースが見つかりません — ID を確認してください
• 422：詳細を含む検証エラー
• 429：レート制限 — 自動再試行

ライセンス

MIT — Saurabh K Shah が作成（https://saurabhshah.com）