Google Workspace MCP サーバー
このモデルコンテキストプロトコル（MCP）サーバーを使えば、Google Workspace を自由に管理できます。アカウントを接続すると（わずか 1 分で完了するシンプルで安全なプロセスです）、すぐに使い始めることができます。MCP サーバーはバックグラウンドで接続を安全かつアクティブに保つため、ログインや権限の管理に煩わされることなく、本来の業務に集中できます。
Gmailの受信トレイを、これまで考えられなかった方法で自在にコントロールしましょう。前四半期の提案書が欲しい？数秒で見つかります。ニュースレターが山積み？自動的にフォルダに振り分けられます。重要なスレッドへの返信を追跡したい？ラベルとフィルタがあなたの代わりに作業してくれます。完璧なメールの作成からチームとの会話の管理まで、すべてがクリックひとつで完了します。添付ファイル処理が合理化されているため、メールの添付ファイルを簡単に見つけて管理でき、複雑なメタデータはシステムが裏で処理します。
カレンダーは日々のスケジュール調整における頼れる味方になります。会議の重複予約やタイムゾーンの混乱はもうありません。チームの同期を計画しているなら、最適な時間枠を見つけてくれます。定期的なワークショップを開催したいなら、一度設定すれば完了です。予定が変更になっても、全員の都合の良い新しい時間を素早く簡単に見つけることができます。「いつ空いてますか？」というメールを延々と送る時代は終わりました。
Google ドライブを、ファイルの山からデジタルコマンドセンターに変えましょう。すべてのドキュメントが適切な場所に、すべてのフォルダが物語を語ります。ファイルを適切な相手と共有すれば、「誰が編集できるの？」という混乱はもうありません。先週の会議で使ったプレゼンテーションを探しているなら、名前だけでなく、ファイルの内容も検索できます。小規模なプロジェクトの整理でも、山積みのドキュメントの管理でも、すべてが必要な場所にきちんと収まります。
TL;DR セットアップ
注: Cline などの AI アシスタントについては、特別なインストール ガイダンスについてはllms-install.md を参照してください。
Google Cloud プロジェクトを作成します。
# Go to Google Cloud Console https://console.cloud.google.com → Create Project → Enable Gmail API and Calendar API → Configure OAuth consent screen (External) → Create OAuth Desktop Client ID and SecretCline 設定に追加します (例:
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):{ "mcpServers": { "google-workspace-mcp": { "command": "docker", "args": [ "run", "--rm", "-i", "-v", "/home/aaron/.mcp/google-workspace-mcp:/app/config", "-v", "/home/aaron/Documents/workspace-mcp-files:/app/workspace", "-e", "GOOGLE_CLIENT_ID", "-e", "GOOGLE_CLIENT_SECRET", "-e", "LOG_MODE=strict", "ghcr.io/aaronsb/google-workspace-mcp:latest" ], "env": { "GOOGLE_CLIENT_ID": "123456789012-abcdef3gh1jklmn2pqrs4uvw5xyz6789.apps.googleusercontent.com", "GOOGLE_CLIENT_SECRET": "GOCSPX-abcdefghijklmnopqrstuvwxyz1234" }, "autoApprove": [], "disabled": false } } }ログモード:
normal（デフォルト）：各ログレベルに適切なコンソールメソッドを使用しますstrict: JSON-RPC以外のすべてのメッセージをstderrにルーティングします（Claudeデスクトップに推奨）
クライン/クロードを再起動
AI に「Google アカウントを追加して」と尋ねるだけで、会話形式で認証プロセスを案内します。
詳細については、詳細なセットアップ ガイドを参照してください。
Related MCP server: MCP G Suite Integration
前提条件
重要：
MCP サーバーを起動する前に、自分で config ディレクトリ (例:~/.mcp/google-workspace-mcp) を作成し、自分のユーザー アカウントが所有していることを確認する必要があります。
このディレクトリが存在しないか、または root によって所有されている場合、サーバーは構成ファイルを作成または更新できず、起動に失敗します。
この MCP サーバーを使用する前に、Google Workspace API にアクセスできる独自の Google Cloud プロジェクトを設定する必要があります。
Google Cloud Consoleで新しいプロジェクトを作成する
必要な API を有効にします。
Gmail API
Google カレンダー API
GoogleドライブAPI
OAuth 同意画面を設定します。
「外部」として設定
自分をテストユーザーとして追加する
Gmail、カレンダー、ドライブに必要なスコープを追加する
OAuth 2.0 認証情報を作成します。
「デスクトップアプリケーション」タイプを選択
クライアントIDとクライアントシークレットをメモしてください
リダイレクトURIとして「urn:ietf:wg:oauth:2.0:oob」を使用します（これにより、帯域外認証が有効になります）
MCP サーバーには次のものが必要です。
上記の手順で取得した Google OAuth クライアント ID とシークレット
構成を保存するためのローカル ディレクトリ パス (推奨:
~/.mcp/google-workspace-mcp)
注: このサーバーは帯域外 (OOB) 認証フローを使用するため、各アカウントの初期設定時に認証コードを手動でコピーして貼り付ける必要があります。
Clineと併用
Cline MCP 設定に次の構成を追加します。
ファイル管理
サーバーは構造化された方法でファイルを自動的に管理します。
WorkspaceManager はこの構造を自動的に作成し、維持します。
ファイルのダウンロード/アップロード時に必要に応じてディレクトリを作成します
ユーザーのメールアドレスでファイルを整理します
一時ファイルのクリーンアップを処理します
適切な権限を維持する
WORKSPACE_BASE_PATH環境変数を設定することで、ワークスペースの場所をカスタマイズできます。
手動使用
重要：
コンテナを起動する前に、マウントする config ディレクトリ (例:~/.mcp/google-workspace-mcp) が存在し、ユーザーが所有している必要があります。
存在しない場合は、mkdir -p ~/.mcp/google-workspace-mcp && chown $USER ~/.mcp/google-workspace-mcpで作成します。
存在しない場合はサーバーは自動的にaccounts.jsonを作成しようとしますが、ディレクトリへの書き込みアクセス権がある場合のみです。
コンテナを直接実行できます。
サーバーは自動的に次の処理を実行します。
必要なすべての構成ファイルを作成して管理する
資格情報とトークンの安全な保管を処理する
適切なファイル権限を維持する
開発ビルド
ローカルビルドスクリプト
高速で CI のようなローカル ビルドと Docker イメージの作成を行うには、提供されているスクリプトを使用します。
デフォルトでは、イメージは
google-workspace-mcp:localとしてタグ付けされます。詳細出力（すべてのログをコンソールに出力）を使用するには、
--verboseを追加します。./scripts/build-local.sh --verboseDocker イメージ タグを変更するには:
./scripts/build-local.sh --tag my-custom-tagログ ファイルは確認のために
/tmp/google-workspace-mcp/に書き込まれます。
ビルドスクリプトは、プラットフォーム固有の設定やBuildKitの機能を使用せずにローカル開発向けに最適化されたDockerfile.localを使用します。これにより、異なる開発環境間での互換性が確保されます。
手動Dockerビルド
コンテナを手動でビルドして実行することもできます。
特徴
自動メタデータ管理による添付ファイル処理の簡素化
重要な情報に重点を置いた合理化された電子メール応答
堅牢な添付ファイルのインデックス作成および検索システム
Gmailとカレンダーをまたいだ効率的なファイル管理
期限切れの添付ファイルの自動クリーンアップ
利用可能なツール
アカウント管理
list_workspace_accounts(エイリアス: list_accounts、get_accounts、show_accounts)設定されているすべてのGoogleアカウントと認証ステータスを一覧表示する
他の操作の前に最初に呼び出す必要があります
必要なAPIスコープを検証する
複数のアカウント選択を処理
authenticate_workspace_account(エイリアス: auth_account、add_account、connect_account)APIアクセス用のGoogleアカウントを追加して認証する
アカウントの分類（仕事用、個人用）をサポート
ユーザーインタラクションによる OAuth フローを処理する
トークンの更新を自動的に管理します
remove_workspace_account(エイリアス: delete_account、disconnect_account、remove_account)Googleアカウントと関連トークンを削除する
保存された資格情報をクリーンアップする
Gmailの操作
メッセージと検索
search_workspace_emails(エイリアス: search_emails、find_emails、query_emails)高度な電子メール フィルタリング機能:
送信者/受信者フィルタリング
件名と内容の検索
日付範囲フィルタリング
添付ファイルの存在
ラベルベースのフィルタリング
複雑な Gmail クエリ構文のサポート
一般的な検索パターン:
会議メール
人事/管理コミュニケーション
チームの最新情報
ニュースレター
send_workspace_email(エイリアス: send_email、send_mail、create_email)完全なフォーマットでメールを送信する
CC/BCC受信者のサポート
添付ファイルの処理
メールスレッドのサポート
設定と構成
get_workspace_gmail_settings(エイリアス: get_gmail_settings、gmail_settings、get_mail_settings)アカウント設定にアクセスする
言語設定
署名の設定
休暇対応者ステータス
フィルタと転送ルール
ドラフト管理
manage_workspace_draft(エイリアス: manage_draft、draft_operation、handle_draft)ドラフトの CRUD 操作を完了します。
新しい下書きを作成する
既存の下書きを読む
下書きコンテンツを更新する
下書きを削除する
下書きを送信
サポート対象:
新しいメールの下書き
スレッドで下書きに返信する
草案の修正
ドラフト送信
ラベル管理
manage_workspace_label(エイリアス: manage_label、label_operation、handle_label)完全なラベルCRUD操作
ネストされたラベルのサポート
カスタムカラー設定
表示設定
manage_workspace_label_assignment(エイリアス: assign_label、modify_message_labels、change_message_labels)メッセージにラベルを適用/削除する
一括ラベル変更
システムラベルの更新
manage_workspace_label_filter(エイリアス: manage_filter、handle_filter、filter_operation)ラベルフィルターの作成と管理
複雑なフィルタリング基準:
送信者/受信者のパターン
件名/内容の一致
添付ファイルの存在
メッセージサイズのルール
自動化されたアクション:
ラベルの適用
重要度のマーク
読み取りステータス
アーカイブ
カレンダー操作
イベント管理
list_workspace_calendar_events(エイリアス: list_events、get_events、show_events)フィルタリング機能を使用してカレンダーイベントを一覧表示する
日付範囲の指定
イベント内のテキスト検索
カスタマイズ可能な結果制限
get_workspace_calendar_event(エイリアス: get_event、view_event、show_event)イベント詳細情報
出席者のステータス
イベント設定
manage_workspace_calendar_event(エイリアス: manage_event、update_event、respond_to_event)イベント対応管理:
招待を承諾/辞退する
暫定としてマーク
新しい時間を提案する
イベント時間の更新
コメントサポート
タイムゾーンの処理
create_workspace_calendar_event(エイリアス: create_event、new_event、schedule_event)新しいカレンダーイベントを作成する
サポート対象:
単一イベント
定期的なイベント（RRULE形式）
複数の参加者
タイムゾーンの指定
イベントの説明
競合チェック
delete_workspace_calendar_event(エイリアス: delete_event、remove_event、cancel_event)カレンダーイベントを削除する
参加者への通知オプション
連絡先操作
get_workspace_contacts(エイリアス: get_contacts、list_contacts、fetch_contacts)Googleアカウントから連絡先を取得する
サポート対象:
基本的な連絡先情報（名前、メールアドレス、電話番号）
詳細な連絡先
大規模な連絡先リストのページ区切り
一般的な使用例:
連絡先の検索
アドレス帳管理
連絡先情報の取得
ドライブ操作
ファイル管理
list_drive_files(エイリアス: list_files、get_files、show_files)オプションのフィルタリングを使用してファイルを一覧表示する
フォルダでフィルタリング
カスタムクエリのサポート
ソートとページ付け
フィールド選択
search_drive_files(エイリアス: search_files、find_files、query_files)ファイル内容全体の全文検索
MIMEタイプでフィルタリング
フォルダでフィルタリング
ゴミ箱内のファイルを含める/除外する
高度なクエリオプション
upload_drive_file(エイリアス: upload_file、create_file、add_file)新しいファイルをアップロードする
ファイルのメタデータを設定する
親フォルダを指定する
さまざまなファイル形式のサポート
download_drive_file(エイリアス: download_file、get_file_content、fetch_file)あらゆるファイル形式をダウンロード
Google Workspace ファイルをエクスポートする
フォーマット変換オプション
自動MIMEタイプ処理
delete_drive_file(エイリアス: delete_file、remove_file、trash_file)ファイルとフォルダを削除する
ドライブからのクリーンな削除
フォルダー操作
create_drive_folder(エイリアス: create_folder、new_folder、add_folder)新しいフォルダを作成する
ネストされたフォルダのサポート
親フォルダの指定
フォルダのメタデータ
権限
update_drive_permissions(エイリアス: share_file、update_sharing、modify_permissions)共有設定を更新する
複数の権限タイプ:
ユーザー権限
グループ権限
ドメイン共有
パブリックアクセス
さまざまなアクセス ロール:
所有者
主催者
ファイルオーガナイザー
ライター
コメント投稿者
リーダー
公開ファイルの検出設定
詳細な使用方法については、 API ドキュメントを参照してください。
近日公開
将来のサービス
管理者SDKのサポート
その他のGoogleサービス
テスト戦略
ユニットテストのアプローチ
簡略化されたモック
予測可能なテストには静的な模擬応答を使用する
ユニットテストで複雑なエンドツーエンドのシミュレーションを避ける
一度に1つの機能のテストに集中する
シンプルな実装で外部依存関係（OAuth、ファイルシステム）をモックする
テスト組織
機能別にテストをグループ化する（例：アカウント操作、ファイル操作）
明確で説明的なテスト名を使用する
テストを集中的かつ分離した状態に保つ
テスト間でモックとモジュールをリセットする
模擬管理
jest.resetModules() を使用してクリーンな状態を確保する
モックの変更後にモジュールを再度要求する
モック関数の呼び出しを明示的に追跡する
関数呼び出しと結果の両方を検証する
ファイルシステムのテスト
シンプルなJSON構造を使用する
フォーマットよりもデータの正確さを重視する
テストエラーのシナリオ（ファイルが見つからない、JSONが無効）
実装の詳細なしでファイル操作を検証する
トークン処理
静的レスポンスによるモックトークン検証
成功と失敗のシナリオを個別にテストする
OAuth の複雑さなしでトークン操作を検証する
アカウントマネージャーのトークン処理ロジックに焦点を当てる
テストの実行
ベストプラクティス
認証
MCP設定で資格情報を安全に保存する
必要最小限のスコープを使用する
トークンの更新を適切に処理する
エラー処理
応答ステータスを確認する
認証エラーを適切に処理する
適切な再試行を実装する
構成とセキュリティ
各ユーザーは独自のGoogle Cloudプロジェクトを管理します
MCP設定でOAuth認証情報を構成する
~/.mcp/google-workspace-mcp 内のトークンの安全な保存
定期的なトークンローテーション
機密ファイルをgitにコミットしない
設定ディレクトリに適切なファイル権限を使用する
ローカル開発環境
MCP設定でOAuth認証情報を構成する
~/.mcp/google-workspace-mcp ディレクトリを作成する
機密トークンをバージョン管理から除外する
各アカウントの認証スクリプトを実行する
トラブルシューティング
一般的なセットアップの問題
構成がありません
エラー: 「GOOGLE_CLIENT_ID 環境変数が必要です」
解決策: MCP 設定ファイルで OAuth 認証情報を設定します (詳細については、docs/API.md を参照してください)。
認証エラー
エラー:「OAuth 認証情報が無効です」
解決：
Google Cloud プロジェクトが適切に構成されていることを確認する
OAuth同意画面で自分自身をテストユーザーとして追加したことを確認してください
Gmail APIとGoogleカレンダーAPIの両方が有効になっていることを確認します
MCP設定の資格情報がOAuthクライアント構成と一致していることを確認します
トークン発行
エラー:「トークンの更新に失敗しました」
解決策:
remove_workspace_accountを使用してアカウントを削除し、再認証しますGoogle Cloud プロジェクトで必要な API スコープが有効になっていることを確認します
ディレクトリ構造
エラー:「ディレクトリが見つかりません」
解決策: ~/.mcp/google-workspace-mcp が適切な権限で存在することを確認します
Dockerがconfigディレクトリをマウントできることを確認する
さらに詳しいヘルプについては、エラー処理のドキュメントを参照してください。
ライセンス
MITライセンス - 詳細はLICENSEファイルを参照