Google Automation MCP

APIs de Google Workspace para agentes de IA: no se requiere proyecto de GCP.

Utiliza clasp para la autenticación. Sin consola de GCP, sin pantalla de consentimiento de OAuth, sin secretos de cliente. Solo autentícate y listo.

Inicio rápido

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

La primera ejecución te guía a través de tres pasos únicos:

1. gmcp auth - abre el navegador para iniciar sesión en Google (OAuth de clasp)

2. Habilitar la API de Apps Script - gmcp auth verifica y te pide que actives la opción en https://script.google.com/home/usersettings (5 segundos)

3. Autorizar alcances - gmcp auth despliega un router de Web App e imprime una URL. Ábrela y haz clic en "Permitir" para conceder acceso a Gmail/Drive/Sheets/Calendar/Docs/Forms/Tasks

4. Listo - ejecuta gmcp o uvx google-automation-mcp para iniciar el servidor

Verifica el estado en cualquier momento: gmcp status

Consejo: Usa el alias corto gmcp después de instalar.

Reautorización: Si una futura actualización añade nuevos alcances, revoca la aplicación en myaccount.google.com/permissions (busca "MCP-Router"), luego visita la URL de la Web App nuevamente desde gmcp status.

Clasp Router vs REST API

Las herramientas de Workspace (Gmail, Drive, Sheets, etc.) pueden operar en dos modos. El router de clasp es el predeterminado y no requiere un proyecto de GCP. La configuración tradicional de la API de Google requiere crear un proyecto de GCP, habilitar APIs, configurar una pantalla de consentimiento de OAuth, añadir usuarios de prueba y crear credenciales.

Cuotas diarias (cuenta de Google de consumidor gratuita)

Nota: Los límites de tiempo de ejecución de Apps Script se comparten entre todos los servicios. El límite de 90 min/día se aplica al tiempo total de ejecución, no por servicio. A ~2s por llamada, eso equivale a ~2,700 llamadas a herramientas/día. Cuotas completas de Apps Script

Selección de backend

El backend se selecciona automáticamente: si GOOGLE_OAUTH_CLIENT_ID y GOOGLE_OAUTH_CLIENT_SECRET están configurados, se utilizan las APIs REST. De lo contrario, el router de clasp maneja las llamadas de Workspace.

Sobrescribe con MCP_USE_ROUTER=true o MCP_USE_ROUTER=false para forzar un backend específico.

Para despliegues de producción multiusuario que requieran tus propias credenciales de OAuth:

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

Seguridad: La IA nunca ve las credenciales

El MCP actúa como un límite de seguridad. Tu agente de IA llama a las herramientas; el MCP maneja la autenticación internamente.

Configuración del cliente MCP

Claude Desktop (Instalación con un clic):

Descarga google-automation-mcp.dxt y ábrelo. Claude Desktop se instalará automáticamente.

Claude Code (~/.mcp.json):

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

Claude Desktop (Manual) (claude_desktop_config.json):

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

Gemini CLI:

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

Herramientas disponibles (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

Soporte multiusuario

Todas las herramientas aceptan user_google_email para el aislamiento de credenciales por usuario:

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

Credenciales almacenadas por separado: ~/.secrets/google-automation-mcp/credentials/{email}.json

Apps Script: Extendiendo Google Workspace

Las herramientas de Apps Script te permiten desplegar código que se ejecuta dentro de las aplicaciones de Google, algo que las APIs REST no pueden hacer:

# 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); }"
}])

Limitaciones

run_script_function requiere una configuración única por script: Abre el script en script.google.com -> Configuración del proyecto -> Cambiar proyecto de GCP -> Desplegar como ejecutable de API. Una vez configurado, las funciones pueden llamarse repetidamente. Todas las demás herramientas funcionan sin esta configuración.

Referencia de CLI

Alias corto: gmcp (o nombre completo: 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

Desarrollo

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

Agradecimientos

Construido sobre google_workspace_mcp por Taylor Wilsdon (Licencia MIT).

Licencia

MIT