MCP Google Calendar And Meet

🚀 Google Meet MCP Server v3.0 - 本番環境対応版

Google Calendar API v3とGoogle Meet API v2を通じて、包括的なGoogle Meet管理を行うための、本番環境対応のエンタープライズ向けモデルコンテキストプロトコル（MCP）サーバーです。Dockerコンテナ化、Smitheryデプロイ、直接トークン認証、チームセキュリティ、および23の完全に検証されたツールを備えたエンタープライズグレードのTypeScriptアーキテクチャを特徴としています。

🚀 クイックスタート

🔨 Smithery（推奨）

• チームや個人ユーザーに最適
• ウェブインターフェイスによるワンクリックデプロイ
• 自動更新とヘルスモニタリング
• 📖 Smitheryユーザーガイドの全文

🐳 Docker

• 完全なコンテナ化による本番デプロイ
• サイズとセキュリティを最適化したマルチステージビルド
• 開発環境と本番環境の設定
• 📖 Dockerデプロイガイド

⚙️ 手動設定

• インストールと設定の完全なコントロール
• 開発環境とカスタムデプロイ
• TypeScriptでの直接Node.js実行
• 📖 手動設定ガイド

🚀 v3.0 - 本番環境対応版の新機能

🎯 v3.0の新機能 - 本番環境向け機能

🐳 Dockerコンテナ化

• ✅ マルチステージ本番ビルド - サイズとセキュリティを最適化（<200MB）
• ✅ Docker Composeによる開発環境と本番環境の設定
• ✅ ヘルスチェックとモニタリング - コンテナネイティブのヘルスエンドポイント
• ✅ セキュリティ強化 - 非ルートユーザー、読み取り専用ファイルシステム
• ✅ ボリューム管理 - 永続的なデータと資格情報の処理

🔨 Smithery統合 + 直接トークン認証

• ✅ 直接トークン認証 - ファイル依存性がない（CLIENT_ID、CLIENT_SECRET、REFRESH_TOKEN）
• ✅ ワンクリックデプロイ - 簡単な設定用のウェブインターフェイス
• ✅ 下位互換性 - 依然としてファイルベースのOAuth資格情報をサポート
• ✅ チームに適した設定 - 個別の資格情報、共有プロジェクト構造
• ✅ 自動ヘルスモニタリング - リアルタイムのサーバーステータスとメトリクス
• ✅ クロスプラットフォームサポート - Windows、macOS、Linux互換
• ✅ 設定検証 - スマートなパス処理とエラー検出

🛡️ セキュリティ強化

• ✅ チームセキュリティポリシー - エンタープライズグレードの資格情報管理
• ✅ 個別の資格情報分離 - ユーザー間で共有シークレットがない
• ✅ コンプライアンスモニタリング - 自動セキュリティとローテーション追跡
• ✅ 監査ログ - Google Cloud Console統合
• ✅ インシデント対応 - セキュリティイベントの文書化された手順

📚 完全なドキュメント

• ✅ すべてのデプロイ方法のユーザーガイド - Smithery、Docker、手動
• ✅ チームオンボーディング手順 - 企業環境向けのステップバイステップガイド
• ✅ トラブルシューティングと診断 - 一般的な問題と自動解決策
• ✅ セキュリティベストプラクティス - 個人およびチームのセキュリティポリシー

📊 本番環境品質メトリクス

• コンテナサイズ：<200MBの本番イメージ
• セキュリティスコア：非ルートユーザー、最小限の攻撃面
• ドキュメントカバレッジ：7つの包括的なガイド（2000行以上）
• デプロイオプション：3つの方法（Smithery、Docker、手動）
• チーム対応：マルチユーザー、エンタープライズセキュリティ、コンプライアンスモニタリング

🎯 強化された核心機能

明確なAPI分離

• 📅 Google Calendar API v3 - ゲスト権限を持つ完全なカレンダーイベント管理
• 🎥 Google Meet API v2 (GA) - スペース管理、会議記録、および参加者追跡

エンタープライズ機能

• 📝 自動文字起こし - 自動会議文字起こしを有効にする
• 🧠 スマートノート - GeminiによるAI生成会議要約
• 📊 出席レポート - 詳細な出席追跡を生成する
• 🛡️ 会議モデレーション - チャット/プレゼンテーションの制限とコントロール
• 👀 ビューアーモード - 参加者をデフォルトでビューアーとして参加させる
• 📹 自動録画 - 自動録画を有効にする（手動でのアクティベーションが必要）

高度なスペース管理

• 🏗️ Google Meet Spaces - 直接的なスペース作成と設定
• 👥 参加者追跡 - 参加者データとセッション情報へのアクセス
• 🔒 アクセスコントロール - OPEN、TRUSTED、またはRESTRICTEDアクセスタイプ
• ⚙️ アーティファクト設定 - 録画、文字起こし、およびスマートノートの設定

🚀 インストールとデプロイ

🔨 Smithery（チームに推奨）

1. Smithery.aiにアクセス
2. 「サーバーをデプロイ」をクリック
3. Googleの資格情報パスを設定
4. Claude Desktopで使用を開始

📖 Smitheryユーザーガイドの全文 - チーム向けのステップバイステップガイド

🐳 Docker（本番環境に推奨）

# 開発環境のクイックスタート
./scripts/docker-deploy.sh dev

# 本番環境のデプロイ
./scripts/docker-deploy.sh prod --backup --fresh

# ステータスを表示
./scripts/docker-deploy.sh status

📖 Dockerデプロイガイド - 完全なコンテナ化

⚙️ 手動インストール

# リポジトリをクローン
git clone https://github.com/INSIDE-HAIR/google-meet-mcp-server.git
cd google-meet-mcp-server

# 依存関係をインストール
npm install

# OAuth資格情報を設定
npm run setup

📖 手動設定ガイド - 完全なコントロールによるインストール

🛡️ セキュリティとチーム管理

🔐 個人セキュリティ

• 各ユーザーが独自のGoogle OAuth資格情報を作成
• チームメンバー間で共有資格情報やトークンがない
• 適切なパーミッション（chmod 600）でセキュアなファイルストレージ
• 📖 セキュリティガイド - 個人のセキュリティベストプラクティス

👥 チームセキュリティ

• 包括的なチームオンボーディング手順
• 企業のGoogle Cloudプロジェクト管理
• 資格情報のローテーションとコンプライアンスモニタリング
• 📖 チームセキュリティガイド - エンタープライズチームのデプロイ

🔧 トラブルシューティング

• 完全な診断と問題解決
• 一般的な問題と解決策
• ヘルスチェックスクリプトとモニタリング
• 📖 トラブルシューティングガイド - 問題解決

💻 使用例

基本的な使用法

# 開発モードでサーバーを起動
npm run start

# TypeScriptモードで設定を実行
npm run setup

高度な使用法

# TypeScriptをJavaScriptにビルド
npm run build

# コンパイルされたサーバーを実行
npm run start:js

テスト

# すべてのテストを実行
npm test

# ウォッチモードでテストを実行
npm run test:watch

# カバレッジレポートを生成
npm run test:coverage

# 型チェックのみ
npm run type-check

🛠️ 利用可能なツール（合計21個） - すべて型安全で検証済み

📅 Google Calendar API v3ツール（6つのツール）

1. calendar_v3_list_calendars ✅ 検証済み

ユーザーが利用可能なすべてのカレンダーをリストする。

検証：パラメーター不要

2. calendar_v3_list_events ✅ 検証済み

フィルタリングオプションを持つ、今後のカレンダーイベントをリストする。

検証：日付形式、最大結果数（1-2500）、カレンダーID形式

3. calendar_v3_get_event ✅ 検証済み

特定のカレンダーイベントの詳細情報を取得する。

検証：必須のevent_idパラメーター

4. calendar_v3_create_event ✅ 検証済み

オプションのGoogle Meet会議を持つ新しいカレンダーイベントを作成する。

検証：必須フィールド、ISO日付形式、ゲスト権限、期間ロジック

パラメーター:

• summary (必須): イベントタイトル
• start_time (必須): ISO形式の開始時間
• end_time (必須): ISO形式の終了時間
• create_meet_conference (オプション): Google Meetを追加
• guest_can_invite_others (オプション): ゲスト招待権限
• guest_can_modify (オプション): ゲスト変更権限
• guest_can_see_other_guests (オプション): ゲスト可視性権限

5. calendar_v3_update_event ✅ 検証済み

既存のカレンダーイベントを更新する。

検証：必須のevent_id、オプションの更新フィールド、時間検証

6. calendar_v3_delete_event ✅ 検証済み

カレンダーイベントを削除する。

検証：必須のevent_idパラメーター

🎥 Google Meet API v2ツール（15個のツール）

7. meet_v2_create_space ✅ 検証済み

高度な設定を持つGoogle Meetスペースを作成する。

検証：アクセスタイプ列挙型、ブールフラグ、制限の組み合わせ

パラメーター:

• access_type: "OPEN" | "TRUSTED" | "RESTRICTED" (デフォルト: "TRUSTED")
• enable_recording: 自動録画準備を有効にする
• enable_transcription: 自動文字起こしを有効にする
• moderation_mode: "ON" | "OFF" 会議モデレーション
• chat_restriction: チャット権限コントロール
• present_restriction: プレゼンテーション権限コントロール

8. meet_v2_get_space ✅ 検証済み

Google Meetスペースの詳細を取得する。

検証：スペース名形式 (spaces/{space_id})

9. meet_v2_update_space ✅ 検証済み

Google Meetスペースの設定を更新する。

10. meet_v2_end_active_conference ✅ 検証済み

Google Meetスペースのアクティブな会議を終了する。

検証：スペース名形式の検証

11. meet_v2_list_conference_records ✅ 検証済み

過去の会議の会議記録をリストする。

検証：フィルター形式、ページサイズ制限（1-50）

12-21. 追加のMeet APIツール ✅ すべて検証済み

• meet_v2_get_conference_record - 特定の会議の詳細を取得する
• meet_v2_list_recordings - 会議録画をリストする
• meet_v2_get_recording - 録画の詳細を取得する
• meet_v2_list_transcripts - 会議文字起こしをリストする
• meet_v2_get_transcript - 文字起こしの詳細を取得する
• meet_v2_list_transcript_entries - 文字起こしの音声セグメントをリストする
• meet_v2_get_participant - 参加者の詳細を取得する
• meet_v2_list_participants - 会議参加者をリストする
• meet_v2_get_participant_session - セッションの詳細を取得する
• meet_v2_list_participant_sessions - 参加者セッションをリストする

検証機能:

• リソース名形式の検証（conferenceRecords/{id}/recordings/{id}）
• ページサイズ制限（エンドポイントに応じて1-1000）
• すべてのGoogle APIリソース識別子の正規表現検証
• ページネーションのスマートデフォルト

Claude Desktop用のMCP設定

Claude Desktopの設定に追加してください。

{
  "mcpServers": {
    "google-meet": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/google-meet-mcp-server/src/index.ts"],
      "env": {
        "G_OAUTH_CREDENTIALS": "/absolute/path/to/credentials.json"
      },
      "disabled": false
    }
  }
}

本番環境設定（コンパイル済みJS）:

{
  "mcpServers": {
    "google-meet": {
      "command": "node",
      "args": ["/absolute/path/to/google-meet-mcp-server/build/index.js"],
      "env": {
        "G_OAUTH_CREDENTIALS": "/absolute/path/to/credentials.json"
      },
      "disabled": false
    }
  }
}

🏗️ エンタープライズアーキテクチャ

TypeScript構造

google-meet-mcp-server/
├── src/
│   ├── index.ts                 # メインMCPサーバー (TypeScript)
│   ├── GoogleMeetAPI.ts         # APIラッパー (完全に型付けされている)
│   ├── setup.ts                 # OAuth設定 (型付けされている)
│   ├── types/                   # 型システム (921行以上)
│   │   ├── google-apis.d.ts        # Google APIの型
│   │   ├── mcp-server.d.ts         # MCP固有の型
│   │   ├── utilities.d.ts          # ブランド型とヘルパー
│   │   └── index.ts                # 集中的なエクスポート
│   ├── validation/              # Zodスキーマ
│   │   └── meetSchemas.ts          # 6つの検証済みツール
│   └── errors/                  # エラーハンドリング
│       └── GoogleApiErrorHandler.ts
├── test/                        # テストスイート (101個のテスト)
│   ├── setup.ts                    # テストユーティリティ
│   ├── GoogleMeetAPI.test.ts       # 単体テスト
│   ├── integration.test.ts         # 統合テスト
│   ├── validation.test.ts          # 検証テスト
│   └── simple.test.ts             # 基本機能
├── build/                       # コンパイルされたJavaScript
├── package.json                 # TypeScript + テスト依存関係
├── tsconfig.json               # TypeScript設定
└── vitest.config.ts            # テスト設定

型安全性機能

// 強化された安全性のためのブランド型
type EventId = Brand<string, 'EventId'>;
type SpaceName = Brand<string, 'SpaceName'>;

// 完全なAPIインターフェース
interface GoogleMeetAPI {
  createMeetSpace(config: SpaceConfigInput): Promise<MeetSpace>;
  listCalendars(): Promise<ProcessedCalendar[]>;
  createCalendarEvent(data: CreateEventInput): Promise<ProcessedEvent>;
}

// ビジネスロジックを持つZod検証
const CreateSpaceSchema = z.object({
  access_type: z.enum(["OPEN", "TRUSTED", "RESTRICTED"]).default("TRUSTED"),
  enable_recording: z.boolean().default(false)
}).refine((data) => {
  // カスタムビジネスロジック検証
  if (data.enable_recording && data.access_type === "OPEN") {
    throw new Error("OPENアクセスの会議では録画を有効にできません");
  }
  return true;
});

エラーハンドリング - Claude Desktop最適化

サーバーは、AIアシスタント向けにコンテキストを考慮したエラーメッセージを提供します。

Google APIエラー

🔐 アクセス拒否
問題: あなたのGoogleアカウントに必要な権限がありません。
解決策: 
1. `npm run setup` を実行して再認証してください
2. すべての要求された権限を付与していることを確認してください
3. エンタープライズ機能の場合は、Google Workspace Business+を持っていることを確認してください

エンタープライズ機能エラー

🏢 エンタープライズ機能が必要です
問題: このMeet機能にはGoogle Workspace Business Standard以上が必要です。
オプション:
- Meetリンク付きの基本的なカレンダーイベントを代わりに使用してください
- Google Workspaceプランをアップグレードしてください
代替案: `calendar_v3_create_event` を `create_meet_conference: true` で試してください

要件

技術要件

• Node.js: 18以上（TypeScriptサポートのため）
• TypeScript: 5以上（依存関係に含まれています）
• Googleアカウント: 基本機能には任意のGoogleアカウントが使用できます

機能要件

• ✅ 基本機能: 任意のGoogleアカウントで動作します
• ✅ カレンダー統合: Google Calendar APIが有効になっている必要があります
• 🏢 エンタープライズ機能: Google Workspace Business Standard以上が必要です
• 🧠 スマートノート: Gemini Business/Enterpriseライセンスが必要です
• 📹 録画: 会議中に手動でアクティベーションする必要があります

開発

TypeScript開発

# ホットリロードで開発
npm run start          # tsx src/index.tsをウォッチモードで実行
npm run setup          # tsx src/setup.tsを実行

# 型チェック
npm run type-check     # tsc --noEmitを実行

# テスト
npm test              # vitest runを実行
npm run test:watch    # ウォッチモードでvitestを実行
npm run test:coverage # カバレッジレポートを生成

本番ビルド

# TypeScriptをビルド
npm run build         # tscを実行してbuild/ディレクトリに出力
npm run clean         # buildディレクトリをクリーンアップ

# コンパイル済みJavaScriptを実行
npm run start:js      # node build/index.jsを実行
npm run setup:js      # node build/setup.jsを実行

テスト結果

✅ テストファイル: 5つすべて合格 (5)
✅ テスト: 101つすべて合格 (101)
✅ 時間: 2.61秒
✅ TypeScript: 0件のコンパイルエラー
✅ 型カバレッジ: ~90%の特定の型

テストカテゴリー:
- 28件のGoogleMeetAPI単体テスト
- 12件の統合ワークフローテスト
- 35件の検証スキーマテスト
- 16件の基本機能テスト
- 10件のMCPサーバーテスト

🔧 一般的な問題と迅速な解決策

🚨 サーバーが起動しない

# 資格情報のパスとパーミッションを確認
ls -la "/path/to/your/credentials.json"
chmod 600 "/path/to/your/credentials.json"

# 設定を検証
npx tsx scripts/health-check.js

🔐 認証に失敗した

# OAuth設定を再実行
G_OAUTH_CREDENTIALS="/path/to/creds.json" npm run setup

# Google Cloud Consoleを確認:
# 1. APIが有効になっていること (Calendar + Meet)
# 2. OAuth同意画面が設定されていること
# 3. スコープが適切に設定されていること

🤖 Claude Desktopの問題

# MCP設定を検証
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Claude Desktopを再起動
# 使用している場合は、Smitheryでサーバーのステータスを確認

📖 トラブルシューティングガイドの全文 - 詳細な問題解決

エンタープライズ機能の制限

Google Meet API v2

• 一部の高度な機能にはGoogle Workspaceライセンスが必要です
• 録画をプログラムで開始することはできません（手動でのアクティベーションが必要です）
• スマートノートにはGemini Business/Enterpriseライセンスが必要です
• 参加者データは完了した会議についてのみ利用可能です

実装に関する注意事項

• すべての21個のツールは公式のGoogle APIを使用して完全に実装されています
• 高度な機能はGoogle Meet API v2への直接REST API呼び出しを使用しています
• 認証とトークン管理は自動的に処理されます
• ブランド型を使用した完全なTypeScriptカバレッジで安全性が確保されています

🤝 貢献の方法

開発要件

• ✅ 適切な型を持つTypeScriptコード（'any'型を使用しない）
• ✅ テストが合格する (npm test) - 100%のテスト成功率を維持する
• ✅ 新しいツールのためのZod検証スキーマ
• ✅ 新しいエンドポイントのためのエラーハンドリング
• ✅ 新しい機能のためのドキュメント更新
• ✅ 資格情報の処理に関するセキュリティレビュー

貢献手順

1. リポジトリをフォークしてクローンする
2. mainから機能ブランチを作成する
3. テストとドキュメントを含めて変更を実装する
4. 完全なテストスイートを実行する (npm test)
5. docs/内の関連ガイドを更新する
6. 詳細な説明を付けてプルリクエストを提出する

📄 ライセンス

ISCライセンス - 商用および個人使用に無料です。詳細についてはLICENSEファイルを参照してください。

---

🎉 Google Meetのワークフローを強化しましょう！上記のデプロイ方法から選択し、数分で始めることができます！

💡 推奨: 最も簡単なセットアップ体験を得るには、Smitheryデプロイから始めてください。

📞 サポートとリソース

📚 ドキュメント

• Smitheryユーザーガイド - Smitheryによるチームデプロイ
• Dockerデプロイガイド - コンテナ化された本番デプロイ
• 手動設定ガイド - 直接的なインストールと設定
• セキュリティガイド - 個人のセキュリティベストプラクティス
• チームセキュリティガイド - エンタープライズチーム管理
• トラブルシューティングガイド - 問題診断と解決

🆘 ヘルプの取得

• 🐛 GitHub Issues - バグレポートと機能要求
• 🔨 Smitheryサポート - プラットフォーム固有のヘルプ
• 📖 MCPドキュメント - モデルコンテキストプロトコルのリソース

🎯 クイックリンク

• リポジトリ: github.com/INSIDE-HAIR/google-meet-mcp-server
• Smitheryページ: smithery.ai/server/@inside-hair/google-meet-mcp-server
• Docker Hub: ghcr.io/inside-hair/google-meet-mcp-server

謝辞

• Model Context Protocol SDKを使用して構築されています。
• Google Calendar APIとGoogle Meet APIを使用しています。
• Claude Desktopや他のMCPクライアントと互換性があります。
• エンタープライズグレードのTypeScriptアーキテクチャを持っています。
• 包括的なZod検証システムを備えています。