Google Automation MCP

AIエージェント向けのGoogle Workspace API - GCPプロジェクトは不要です。

認証には clasp を使用します。GCPコンソール、OAuth同意画面、クライアントシークレットは不要です。認証するだけですぐに使えます。

クイックスタート

uvx google-automation-mcp auth   # 1. Browser sign-in via clasp
uvx google-automation-mcp        # 4. Run server

初回実行時に、以下の3つの1回限りの手順を案内します：

1. gmcp auth - Googleサインイン（clasp OAuth）のためにブラウザを開きます

2. Apps Script APIを有効化 - gmcp auth がチェックを行い、https://script.google.com/home/usersettings でONにするよう促します（5秒で完了）

3. スコープの承認 - gmcp auth がWebアプリルーターをデプロイし、URLを表示します。それを開き、「許可」をクリックしてGmail/Drive/Sheets/Calendar/Docs/Forms/Tasksへのアクセスを許可します

4. 完了 - gmcp または uvx google-automation-mcp を実行してサーバーを起動します

ステータスの確認はいつでも可能です：gmcp status

ヒント: インストール後は短いエイリアス gmcp を使用してください。

再承認: 将来のアップデートで新しいスコープが追加された場合は、myaccount.google.com/permissions でアプリ（「MCP-Router」を探す）を取り消し、gmcp status からWebアプリのURLに再度アクセスしてください。

Claspルーター vs REST API

Workspaceツール（Gmail、Drive、Sheetsなど）は2つのモードで動作します。Claspルーターがデフォルトであり、GCPプロジェクトは不要です。従来のGoogle API設定では、GCPプロジェクトの作成、APIの有効化、OAuth同意画面の設定、テストユーザーの追加、認証情報の作成が必要です。

1日のクォータ（無料の個人用Googleアカウント）

注: Apps Scriptの実行制限はすべてのサービスで共有されます。90分/日の制限はサービスごとではなく、合計実行時間に適用されます。1呼び出しあたり約2秒とすると、1日あたり約2,700回のツール呼び出しが可能です。Apps Scriptのクォータ詳細

バックエンドの選択

バックエンドは自動的に選択されます。GOOGLE_OAUTH_CLIENT_ID と GOOGLE_OAUTH_CLIENT_SECRET が設定されている場合はREST APIが使用されます。それ以外の場合は、ClaspルーターがWorkspace呼び出しを処理します。

MCP_USE_ROUTER=true または MCP_USE_ROUTER=false で上書きし、特定のバックエンドを強制することも可能です。

独自のOAuth認証情報を必要とするマルチユーザーの本番環境デプロイの場合：

export GOOGLE_OAUTH_CLIENT_ID='...'
export GOOGLE_OAUTH_CLIENT_SECRET='...'
gmcp auth --oauth21

セキュリティ: AIは認証情報を見ることができません

このMCPはセキュリティ境界として機能します。AIエージェントはツールを呼び出し、MCPが内部で認証を処理します。

MCPクライアント設定

Claude Desktop (ワンクリックインストール):

google-automation-mcp.dxt をダウンロードして開きます。Claude Desktopが自動的にインストールします。

Claude Code (~/.mcp.json):

{
  "mcpServers": {
    "google": {
      "type": "stdio",
      "command": "uvx",
      "args": ["google-automation-mcp"]
    }
  }
}

Claude Desktop (手動) (claude_desktop_config.json):

{
  "mcpServers": {
    "google": {
      "command": "uvx",
      "args": ["google-automation-mcp"]
    }
  }
}

Gemini CLI:

gemini extensions install github:sam-ent/google-automation-mcp

利用可能なツール (60)

Gmail (5)

search_gmail_messages · get_gmail_message · send_gmail_message · list_gmail_labels · modify_gmail_labels

Drive (10)

search_drive_files · list_drive_items · get_drive_file_content · create_drive_file · create_drive_folder · delete_drive_file · trash_drive_file · share_drive_file · list_drive_permissions · remove_drive_permission

Sheets (6)

list_spreadsheets · get_sheet_values · update_sheet_values · append_sheet_values · create_spreadsheet · get_spreadsheet_metadata

Calendar (5)

list_calendars · get_events · create_event · update_event · delete_event

Docs (5)

get_doc_content · search_docs · create_doc · modify_doc_text · append_doc_text

Forms (4)

get_form · create_form · add_form_question · get_form_responses

Tasks (6)

list_task_lists · get_tasks · create_task · update_task · delete_task · complete_task

Apps Script (17)

list_script_projects · get_script_project · get_script_content · create_script_project · update_script_content · delete_script_project · run_script_function · create_deployment · list_deployments · update_deployment · delete_deployment · list_versions · create_version · get_version · list_script_processes · get_script_metrics · generate_trigger_code

Auth (2)

start_google_auth · complete_google_auth

マルチユーザーサポート

すべてのツールは、ユーザーごとの認証情報を分離するために user_google_email を受け入れます：

search_gmail_messages(user_google_email="alice@example.com", query="is:unread")
search_gmail_messages(user_google_email="bob@example.com", query="is:unread")

認証情報は個別に保存されます：~/.secrets/google-automation-mcp/credentials/{email}.json

Apps Script: Google Workspaceの拡張

Apps Scriptツールを使用すると、Googleアプリ内で実行されるコードをデプロイできます。これはREST APIでは不可能なことです：

# Create a bound script with custom function
create_script_project(title="Validator", parent_id="SPREADSHEET_ID")
update_script_content(script_id="...", files=[{
    "name": "Code",
    "type": "SERVER_JS",
    "source": "function VALIDATE_EMAIL(e) { return /^[^@]+@[^@]+\\.[^@]+$/.test(e); }"
}])

制限事項

run_script_function は、スクリプトごとに1回限りのセットアップが必要です：script.google.com でスクリプトを開く -> プロジェクトの設定 -> GCPプロジェクトを変更 -> API実行可能ファイルとしてデプロイ。一度設定すれば、関数は繰り返し呼び出すことができます。他のすべてのツールはこの設定なしで動作します。

CLIリファレンス

短いエイリアス: gmcp (またはフルネーム: google-automation-mcp)

gmcp                 # Run server
gmcp setup           # Interactive setup wizard
gmcp auth            # Authenticate with clasp
gmcp auth --oauth21  # OAuth 2.1 for production
gmcp status          # Check auth status
gmcp version         # Show version

開発

git clone https://github.com/sam-ent/google-automation-mcp.git
cd google-automation-mcp
uv sync
uv run pytest tests/ -v  # 183 tests

謝辞

Taylor Wilsdon氏による google_workspace_mcp (MITライセンス) を基に構築されています。

ライセンス

MIT