GSuite

Servidor MCP mcp-gsuite

Servidor MCP para interactuar con productos de Google.

Ejemplos de solicitudes

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

1. General

• Múltiples cuentas de Google

2. 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 adjuntos)
• Recuperar el contenido completo del correo por ID
• Crear borradores de correos electrónicos con destinatarios, asunto, cuerpo y opciones de CC
• Eliminar borradores de correos
• Responder a correos existentes (se puede enviar inmediatamente o guardar como borrador)
• Recuperar múltiples correos a la vez por sus ID.
• Guardar múltiples adjuntos de correos en su sistema local.

3. Calendar

• Gestionar múltiples calendarios
• Obtener eventos de calendario en rangos de tiempo específicos
• Crear eventos de 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 de calendario

Ejemplos de solicitudes que puede probar:

• Recuperar mis últimos mensajes no leídos

• Buscar mis correos del Scrum Master

• Recuperar todos los correos de contabilidad

• Tomar el correo sobre ABC y resumirlo

• Escribir una buena respuesta 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 planear un evento con Tim por 2 horas la próxima semana. Sugiere algunos horarios.

Inicio rápido

Instalación

Instalación mediante Smithery

Para instalar mcp-gsuite para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install 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 de OAuth con la información requerida
   • Agregue URIs 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"
   ]

3. 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"
    }
}

4. Cree un archivo .accounts.json con 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 porque puede agregar aquí información que desea 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, se le redirigirá a Google y se le pedirán sus credenciales, ámbito, etc. Después de un inicio de sesión exitoso, se almacenan 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

{
  "mcpServers": {
    "mcp-gsuite": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-gsuite",
        "run",
        "mcp-gsuite"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-gsuite": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-gsuite",
        "run",
        "mcp-gsuite",
        "--accounts-file",
        "/path/to/custom/.accounts.json",
        "--credentials-dir",
        "/path/to/custom/credentials"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-gsuite": {
      "command": "uvx",
      "args": [
        "mcp-gsuite",
        "--accounts-file",
        "/path/to/custom/.accounts.json",
        "--credentials-dir",
        "/path/to/custom/credentials"
      ]
    }
  }
}

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 útil en escenarios de desarrollo y prueba.

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 al implementar en entornos donde las rutas predeterminadas no son adecuadas.

Desarrollo

Construcción y publicación

Para preparar el paquete para distribución:

1. Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

2. Construir distribuciones del paquete:

uv build

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

3. Publicar en PyPI:

uv publish

Nota: Necesitará configurar las credenciales de PyPI mediante variables de entorno o banderas de línea de comandos:

• Token: --token o UV_PUBLISH_TOKEN
• O 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 una mejor experiencia de depuración, recomendamos encarecidamente usar MCP Inspector.

Puede lanzar el MCP Inspector mediante npm con este comando:

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

Al lanzarse, el Inspector mostrará una URL 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