Google Automation MCP

API Google Workspace для ИИ-агентов — проект GCP не требуется.

Использует clasp для аутентификации. Никакой консоли GCP, никаких экранов согласия OAuth, никаких секретов клиента. Просто пройдите аутентификацию и работайте.

Быстрый старт

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

Первый запуск проведет вас через три однократных шага:

1. gmcp auth — открывает браузер для входа в Google (clasp OAuth)

2. Включите Apps Script API — gmcp auth проверит и предложит вам включить его по адресу https://script.google.com/home/usersettings (5 секунд)

3. Авторизуйте области доступа (scopes) — gmcp auth развернет маршрутизатор Web App и выведет URL. Откройте его, нажмите "Разрешить", чтобы предоставить доступ к Gmail/Drive/Sheets/Calendar/Docs/Forms/Tasks

4. Готово — запустите gmcp или uvx google-automation-mcp, чтобы запустить сервер

Проверяйте статус в любое время: gmcp status

Совет: Используйте короткий псевдоним gmcp после установки.

Повторная авторизация: Если в будущем обновлении добавятся новые области доступа, отзовите приложение на myaccount.google.com/permissions (найдите "MCP-Router"), затем снова посетите URL Web App из gmcp status.

Clasp Router против REST API

Инструменты Workspace (Gmail, Drive, Sheets и т. д.) могут работать в двух режимах. Clasp router используется по умолчанию и не требует проекта GCP. Традиционная настройка Google API требует создания проекта GCP, включения API, настройки экрана согласия OAuth, добавления тестовых пользователей и создания учетных данных.

Ежедневные квоты (бесплатный потребительский аккаунт Google)

Примечание: Лимиты времени выполнения Apps Script являются общими для всех сервисов. Лимит 90 мин/день применяется к общему времени выполнения, а не к каждому сервису отдельно. При ~2 с на вызов это около 2 700 вызовов инструментов в день. Полные квоты Apps Script

Выбор бэкенда

Бэкенд выбирается автоматически: если установлены GOOGLE_OAUTH_CLIENT_ID и GOOGLE_OAUTH_CLIENT_SECRET, используются REST API. В противном случае вызовы Workspace обрабатываются через clasp router.

Переопределите с помощью MCP_USE_ROUTER=true или MCP_USE_ROUTER=false, чтобы принудительно выбрать конкретный бэкенд.

Для многопользовательских продакшен-развертываний, требующих ваших собственных учетных данных OAuth:

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

Безопасность: ИИ никогда не видит учетные данные

MCP выступает в качестве границы безопасности. Ваш ИИ-агент вызывает инструменты; 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 требует однократной настройки для каждого скрипта: откройте скрипт на 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

Благодарности

Создано на основе google_workspace_mcp от Тейлора Уилсдона (лицензия MIT).

Лицензия

MIT