GSuite

Interactúa con productos de Google, incluyendo Gmail y Calendar.

GitHub
3
Prueba este MCPPatrocinado

Documentación

Servidor MCP mcp-gsuite

smithery badge Servidor MCP para interactuar con los productos de Google.

Ejemplos de prompts

Actualmente, este servidor MCP admite la integración con Gmail y Calendar con las siguientes capacidades:

  1. General
  • Múltiples cuentas de Google
  1. Gmail
  • Obtener información del usuario de Gmail
  • Consultar correos electrónicos con búsqueda flexible (por ejemplo, no leídos, de remitentes específicos, rangos de fechas, con archivos adjuntos)
  • Recuperar el contenido completo del correo electrónico por ID
  • Crear nuevos borradores de correos electrónicos con destinatarios, asunto, cuerpo y opciones de CC
  • Eliminar borradores de correos electrónicos
  • Responder a correos electrónicos existentes (puede enviar inmediatamente o guardar como borrador)
  • Recuperar múltiples correos electrónicos a la vez por sus IDs.
  • Guardar múltiples archivos adjuntos de correos electrónicos en su sistema local.
  1. Calendar
  • Gestionar múltiples calendarios
  • Obtener eventos del calendario dentro de rangos de tiempo especificados
  • Crear eventos del calendario con:
    • Título, horas de inicio/fin
    • Ubicación y descripción opcionales
    • Asistentes opcionales
    • Soporte de zona horaria personalizada
    • Preferencias de notificación
  • Eliminar eventos del calendario

Ejemplos de prompts que puede probar:

  • Recuperar mis últimos mensajes no leídos

  • Buscar mis correos electrónicos del Scrum Master

  • Recuperar todos los correos electrónicos de contabilidad

  • Tomar el correo electrónico sobre ABC y resumirlo

  • Escribir una respuesta agradable al último correo de Alice y subir un borrador.

  • Responder al correo de Bob con una nota de agradecimiento. Guardarlo como borrador

  • ¿Qué tengo en mi agenda para mañana?

  • Revisar la agenda familiar de mi cuenta privada para la próxima semana

  • Necesito planificar un evento con Tim durante 2 horas la próxima semana. Sugerir algunos espacios de tiempo.

Inicio rápido

Instalación

Instalación mediante Smithery

Para instalar la Integración de G Suite para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @alBERT-launcher/mcp-gsuite --client claude

Oauth 2

Las API de Google Workspace (G Suite) requieren autorización OAuth2. Siga estos pasos para configurar la autenticación:

  1. Crear Credenciales OAuth2:

    • Vaya a la Consola de Google Cloud
    • Cree un nuevo proyecto o seleccione uno existente
    • Habilite la API de Gmail y la API de Google Calendar para su proyecto
    • Vaya a "Credenciales" → "Crear credenciales" → "ID de cliente OAuth"
    • Seleccione "Aplicación de escritorio" o "Aplicación web" como tipo de aplicación
    • Configure la pantalla de consentimiento OAuth con la información requerida
    • Agregue URI de redireccionamiento autorizados (incluya http://localhost:4100/code para desarrollo local)

  2. Ámbitos OAuth2 requeridos:

   [
     "openid",
     "https://mail.google.com/",
     "https://www.googleapis.com/auth/calendar",
     "https://www.googleapis.com/auth/userinfo.email"
   ]
  1. Luego cree un .gauth.json en su directorio de trabajo con el cliente
{
    "web": {
        "client_id": "$your_client_id",
        "client_secret": "$your_client_secret",
        "redirect_uris": ["http://localhost:4100/code"],
        "auth_uri": "https://accounts.google.com/o/oauth2/auth",
        "token_uri": "https://oauth2.googleapis.com/token"
    }
}
  1. Cree un archivo .accounts.json con la información de la cuenta
{
    "accounts": [
        {
            "email": "alice@bob.com",
            "account_type": "personal",
            "extra_info": "Additional info that you want to tell Claude: E.g. 'Contains Family Calendar'"
        }
    ]
}

Puede especificar múltiples cuentas. Asegúrese de que tengan acceso en su aplicación de Google Auth. El campo extra_info es especialmente interesante, ya que puede agregar información aquí que desee comunicar a la IA sobre la cuenta (por ejemplo, si tiene una agenda específica).

Nota: Cuando ejecute por primera vez una de las herramientas para una cuenta específica, se abrirá un navegador, lo redirigirá a Google y le pedirá sus credenciales, ámbitos, etc. Después de un inicio de sesión exitoso, almacena las credenciales en un archivo local llamado .oauth.{email}.json. Una vez autorizado, se utilizará el token de actualización.

Claude Desktop

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuración de Servidores No Publicados 
{
  "mcpServers": {
    "mcp-gsuite": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-gsuite",
        "run",
        "mcp-gsuite"
      ]
    }
  }
}
Configuración de Servidores Publicados 
{
  "mcpServers": {
    "mcp-gsuite": {
      "command": "uvx",
      "args": [
        "mcp-gsuite"
      ]
    }
  }
}

Opciones de Configuración

El servidor MCP se puede configurar con varias opciones de línea de comandos para especificar rutas personalizadas para la autenticación e información de cuentas:

  • --gauth-file: Especifica la ruta al archivo .gauth.json que contiene la configuración del cliente OAuth2. El valor predeterminado es ./.gauth.json.
  • --accounts-file: Especifica la ruta al archivo .accounts.json que contiene información sobre las cuentas de Google. El valor predeterminado es ./.accounts.json.
  • --credentials-dir: Especifica el directorio donde se almacenan las credenciales OAuth después de una autenticación exitosa. El valor predeterminado es el directorio de trabajo actual con un subdirectorio para cada cuenta como .oauth.{email}.json.

Estas opciones permiten flexibilidad en la gestión de diferentes entornos o múltiples conjuntos de credenciales y cuentas, especialmente útiles en escenarios de desarrollo y pruebas.

Ejemplo de uso:

uv run mcp-gsuite --gauth-file /path/to/custom/.gauth.json --accounts-file /path/to/custom/.accounts.json --credentials-dir /path/to/custom/credentials

Esta configuración es particularmente útil cuando tiene múltiples instancias del servidor ejecutándose con diferentes configuraciones o cuando se implementa en entornos donde las rutas predeterminadas no son adecuadas.

Desarrollo

Compilación y Publicación

Para preparar el paquete para distribución:

  1. Sincronizar dependencias y actualizar el archivo de bloqueo:
uv sync
  1. Compilar distribuciones del paquete:
uv build

Esto creará distribuciones de fuente y wheel en el directorio dist/.

  1. Publicar en PyPI:
uv publish

Nota: Necesitará establecer credenciales de PyPI mediante variables de entorno o banderas de comando:

  • Token: --token o UV_PUBLISH_TOKEN
  • O nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan sobre stdio, la depuración puede ser desafiante. Para la mejor experiencia de depuración, recomendamos encarecidamente usar el Inspector MCP.

Puede lanzar el Inspector MCP mediante npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite

Al lanzarlo, el Inspector mostrará una URL a la que puede acceder en su navegador para comenzar a depurar.

También puede ver los registros del servidor con este comando:

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log