managing-google-workspace

Google Workspace — ツールルーター

実行モード

利用可能なモードを検出して使用してください。

MCP（推奨）

google-workspace サーバーの MCP ツールが利用可能な場合は、直接呼び出してください。以下の表にあるツール名はベース名です。必要に応じてサーバー名を先頭に付けてください（例：google-workspace:search_gmail_messages）。

CLI（MCP なし）

MCP ツールが利用できない場合は、実行中のサーバーを workspace-cli 経由で呼び出してください。

workspace-cli list
workspace-cli call <tool_name> key=value ...

• ツールスキーマで必要な場合（USER_GOOGLE_EMAIL が設定されていない、旧式の OAuth 2.0 の場合）にのみ user_google_email=USER_EMAIL を渡してください。OAuth 2.1 およびトラステッドゲートウェイサーバーでは、検証済みの ID から取得するため、省略してください。
• 引数は key=value 形式です。値は可能な場合 JSON として解析されるため、リストやオブジェクトは JSON で渡してください（例：label_ids='["INBOX"]'）。
• サーバーは HTTP 経由で到達可能である必要があります。デフォルト URL は http://localhost:8000/mcp です（--transport streamable-http で起動したサーバー）。--url をサブコマンドの前に指定するか（workspace-cli --url <url> call ...）、WORKSPACE_MCP_URL を設定して上書きしてください。stdio を使用するプラグインでは、WORKSPACE_MCP_HTTP_PORT を設定すると、http://127.0.0.1:<port>/mcp にループバックサイドカーを公開できます。
• workspace-cli が PATH にない場合は、このリポジトリのチェックアウトから uv run workspace-cli を実行してください。恒久的なインストール（そのチェックアウトでの uv tool install .）は、ユーザーが手動で行うセットアップ手順です。無関係な放棄済みの PyPI パッケージがその名前を占有しているため、uvx workspace-cli は絶対に使用しないでください。

ツールを呼び出す前に、正確なパラメーター名と型を確認するため、該当するリファレンスファイルを読んでください。そこに記載されたパラメーターのみを使用し、パラメーターを作り出さないでください。

初回セットアップ

ツール呼び出しが認証情報エラーで失敗した場合は、ユーザーを次のセットアップ手順に案内してください。

1. OAuth 認証情報を作成する

ユーザーに Google Cloud Console を案内してください。

• OAuth 2.0 クライアント ID を作成します（デスクトップアプリケーションの種類）
• 必要な Google API（Gmail、Drive、Calendar など）を有効にします
• クライアント ID とクライアントシークレットをコピーします

2. 認証情報を保存する

ユーザー自身で ~/.claude/settings.local.json を編集するよう案内してください（このファイルは gitignore 対象で、共有されることはありません）。会話にシークレットを貼り付けるよう求めないでください。次の内容を env ブロックに追加するよう伝えてください。

{
  "env": {
    "GOOGLE_OAUTH_CLIENT_ID": "their-client-id",
    "GOOGLE_OAUTH_CLIENT_SECRET": "their-secret"
  }
}

settings.local.json がすでに存在する場合は、既存の env オブジェクトを置き換えずにマージしてください。これらの環境変数は、Claude Code が起動するすべての MCP サーバーと CLI プロセスに継承されます。

3. 認証する

• MCP モード：start_google_auth を呼び出してブラウザーで OAuth フローを開始します
• CLI モード：任意のツールを実行します。初回の呼び出しで OAuth フローが開始されます
• 認証情報は、今後のセッションに備えて ~/.google_workspace_mcp/credentials（または WORKSPACE_MCP_CREDENTIALS_DIR で設定した場所）にキャッシュされます

サーバーのオプション、トランスポート、認証モード、ツールのフィルタリング、デプロイについては、references/server-options.md を参照してください。

共通パターン

• 統合された「manage」ツールでは、作成／更新／削除に action パラメーターを使用します。

ツールリファレンス

Gmail

タスク	ツール
メールを検索する	search_gmail_messages
メールを1件読む	get_gmail_message_content
複数のメールを読む	get_gmail_messages_content_batch
スレッドを読む	get_gmail_thread_content
複数のスレッドを読む	get_gmail_threads_content_batch
メールを送信する（新規または返信）	send_gmail_message
下書きを作成する	draft_gmail_message
添付ファイルをダウンロードする	get_gmail_attachment_content
ラベルを追加／削除する（1件）	modify_gmail_message_labels
ラベルを追加／削除する（一括）	batch_modify_gmail_message_labels
ラベルを管理する	manage_gmail_label
ラベルを一覧表示する	list_gmail_labels
フィルターを管理する	manage_gmail_filter
フィルターを一覧表示する	list_gmail_filters

パラメーターについては、references/gmail.md を参照してください。

Google Drive

タスク	ツール
ファイル／フォルダーを検索	search_drive_files
フォルダー内のアイテムを一覧表示	list_drive_items
ファイルの内容を読み取る	get_drive_file_content
ファイルをダウンロード	get_drive_file_download_url
ファイルを作成	create_drive_file
フォルダーを作成	create_drive_folder
ファイルをコピー	copy_drive_file
ファイルのメタデータを更新	update_drive_file
共有／権限を設定	set_drive_file_permissions
アクセスを管理（追加／削除）	manage_drive_access
権限を確認	get_drive_file_permissions
共有可能なリンクを取得	get_drive_shareable_link
公開アクセスを確認	check_drive_file_public_access
ファイルを Google ドキュメントにインポート	import_to_google_doc
スプレッドシート（XLSX、CSV、...）を Google スプレッドシートにインポート	import_to_google_sheets
プレゼンテーション（PPTX、...）を Google スライドにインポート	import_to_google_slides

パラメーターについては、references/drive.md を参照してください。

Google Calendar

タスク	ツール
カレンダーを一覧表示	list_calendars
サブカレンダーを作成	create_calendar
イベントを取得	get_events
イベントを作成／更新／削除	manage_event
不在設定（自動辞退）	manage_out_of_office
集中時間（自動辞退、DND）	manage_focus_time
空き状況を確認	query_freebusy

パラメーターについては、references/calendar.md を参照してください。

Google Docs

タスク	ツール
ドキュメントを Markdown として読み取る	get_doc_as_markdown
ドキュメントの内容を読み取る（未加工）	get_doc_content
リンク／チップの参照先とドキュメントのセグメントを保持してプレーンテキストを読み取る	get_doc_content(preserve_context=True)
新しいドキュメントを作成	create_doc
テキストを変更／スタイルを適用（インデックスまたは heading を指定）	modify_doc_text
要素（表、リスト、区切り）を挿入	insert_doc_elements
画像を挿入	insert_doc_image
データを含む表を作成	create_table_with_data
段落スタイルを更新	update_paragraph_style
検索して置換	find_and_replace_doc
構造を確認	inspect_doc_structure
一括更新（複数の操作）	batch_update_doc
ヘッダー／フッター	update_doc_headers_footers
タブを管理	manage_doc_tab
PDF にエクスポート	export_doc_to_pdf
フォルダー内のドキュメントを一覧表示	list_docs_in_folder
ドキュメントを検索	search_docs
コメント	manage_document_comment / list_document_comments
表の構造をデバッグ	debug_table_structure

パラメーターについては、references/docs.md を参照してください。

Google Sheets

タスク	ツール
セルの値を読み取る	read_sheet_values
値を書き込み／追加／クリア	modify_sheet_values
スマートチップを挿入	modify_sheet_values (chips)
セルを書式設定	format_sheet_range
条件付き書式	manage_conditional_formatting
スプレッドシートの情報を取得	get_spreadsheet_info
スプレッドシートを作成	create_spreadsheet
シート（タブ）を作成	create_sheet
タブの名前変更／削除／非表示／並べ替え／スタイル設定	manage_sheet_tab
行と列のサイズ変更／固定／非表示／挿入／削除	resize_sheet_dimensions
シート間で行を移動	move_sheet_rows
構造化テーブルを一覧表示	list_sheet_tables
構造化テーブルに行を追加	append_table_rows
名前付き範囲を管理	manage_named_range
スプレッドシートを一覧表示	list_spreadsheets
コメント	manage_spreadsheet_comment / list_spreadsheet_comments

パラメーターについては、references/sheets.md を参照してください。

Google Slides

タスク	ツール
プレゼンテーションを取得	get_presentation
特定のスライドを取得	get_page
スライドを確認（画像にレンダリング）	render_page_to_image
プレゼンテーションを作成	create_presentation
一括更新	batch_update_presentation
スピーカーノート	get_presentation (include_speaker_notes) + batch_update_presentation
コメント	manage_presentation_comment / list_presentation_comments

パラメーターについては、references/slides.md を参照してください。

Google Forms

タスク	ツール
フォームを取得	get_form
フォームを作成	create_form
フォームを一括更新	batch_update_form
回答を一覧表示	list_form_responses
回答を1件取得	get_form_response
公開設定	set_publish_settings

パラメーターについては、references/forms.md を参照してください。

Google Tasks

タスク	ツール
タスクリストを一覧表示	list_task_lists
タスクリストを取得	get_task_list
タスクリストを管理（CRUD）	manage_task_list
タスクを一覧表示	list_tasks
タスクを取得	get_task
タスクを管理（CRUD／移動）	manage_task

パラメーターについては、references/tasks.md を参照してください。

Google Contacts

タスク	ツール
連絡先を検索	search_contacts
連絡先を取得	get_contact
連絡先を管理（CRUD）	manage_contact
連絡先を一括管理	manage_contacts_batch
連絡先グループを一覧表示	list_contact_groups
連絡先グループを取得	get_contact_group
連絡先グループを管理	manage_contact_group
すべての連絡先を一覧表示	list_contacts

パラメーターについては、references/contacts.md を参照してください。

Google Chat

タスク	ツール
スペースを一覧表示	list_spaces
メッセージを取得	get_messages
メッセージを検索	search_messages
メッセージを送信	send_message
送信済みメッセージを編集	send_message (message_name)
メッセージにリアクションする	create_reaction
添付ファイルをダウンロード	download_chat_attachment

パラメーターについては、references/chat.md を参照してください。

Google Apps Script

タスク	ツール
プロジェクト／ファイル（一覧表示／取得）	get_script_project (action)
プロジェクト（作成／削除）	manage_script_project (action)
ファイルの内容（更新）	manage_script_content (action="update")
関数を実行	run_script_function
トリガーコードを生成	generate_trigger_code
デプロイメント（一覧表示）	list_script_deployments
デプロイメント（作成／更新／削除）	manage_deployment (action)
バージョン（一覧表示／取得）	get_script_version (action)
バージョン（作成）	manage_script_version (action="create")
実行メトリクス／プロセス履歴	get_script_activity (action="metrics" / "processes")
現在のユーザーのトリガー（一覧表示／削除）	manage_script_trigger (action)

パラメーターについては、references/apps-script.md を参照してください。

Google Custom Search

タスク	ツール
ウェブ検索	search_custom
検索エンジン情報を取得	get_search_engine_info

パラメーターについては、references/search.md を参照してください。

認証

タスク	ツール
OAuth フローを開始	start_google_auth

レガシー OAuth 2.0 のみ — OAuth 2.1 が有効な場合は無効になります。ほとんどの場合、必要なツールを呼び出すだけで認証が自動的に行われます。パラメーターについては、references/server-options.md を参照してください。

よくあるワークフロー

メールに返信する

1. search_gmail_messages -- メールを検索します
2. get_gmail_message_content -- メールを読み取ります（message_id と thread_id を取得します）
3. send_gmail_message -- thread_id を使って返信します。返信ヘッダーを省略すると、RFC Message-ID を持つ最新の下書きでもゴミ箱内でもないメッセージが対象になります

ファイルを見つけて共有する

1. search_drive_files -- ファイルを検索します
2. manage_drive_access -- ファイルを共有します
3. get_drive_shareable_link -- リンクを取得します

スプレッドシートを読み取り、更新する

1. get_spreadsheet_info -- シート名を取得します
2. read_sheet_values -- 現在のデータを読み取ります
3. modify_sheet_values -- 更新したデータを書き込みます
4. read_sheet_values -- 更新を確認します

書式付きドキュメントを作成する

1. create_doc -- ドキュメントを作成します
2. modify_doc_text -- 書式を設定してテキストを追加します
3. insert_doc_elements -- 表、リスト、改ページを追加します
4. update_paragraph_style -- 見出しのスタイルを適用します
5. get_doc_as_markdown -- 結果を確認します

メールの添付ファイルを処理する

1. search_gmail_messages -- メールを検索します
2. get_gmail_message_content -- 添付ファイルのメタデータを取得します
3. get_gmail_attachment_content -- 添付ファイルをダウンロードします

Google ドキュメントを編集する

1. get_doc_as_markdown -- 現在の内容を読み取ります
2. inspect_doc_structure -- 挿入位置とインデックスを確認します
3. modify_doc_text / insert_doc_elements -- 変更を加えます
4. get_doc_as_markdown -- 結果を確認します

ヒント

• パラメーターを確認する：リファレンスファイルには、すべてのツールの各パラメーターが記載されています。CLI モードでは、workspace-cli list を実行すると、実行中のサーバーが公開しているツールを確認できます。