Servidor MCP mcp-gsuite

Servidor MCP para interactuar con productos de Google.

Ejemplos de indicaciones

En este momento, este servidor MCP admite la integración de Gmail y Calendario con las siguientes capacidades:

General

Varias cuentas de Google

Gmail

Obtén tu información de 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 CC
Eliminar borradores de correos electrónicos
Responder a correos electrónicos existentes (puede enviarlos inmediatamente o guardarlos como borrador)
Recupere varios correos electrónicos a la vez por sus identificaciones.
Guarde varios archivos adjuntos de correos electrónicos en su sistema local.

Calendario

Administrar múltiples calendarios
Obtener eventos del calendario dentro de rangos de tiempo específicos
Crea eventos de calendario con:
- Título, hora de inicio y fin
- Ubicación y descripción opcionales
- Asistentes opcionales
- Compatibilidad con zonas horarias personalizadas
- Preferencias de notificación
Eliminar eventos del calendario

Ejemplos de indicaciones que puedes probar:

Recuperar mis últimos mensajes no leídos
Busque mis correos electrónicos del Scrum Master
Recuperar todos los correos electrónicos de contabilidad
Tome el correo electrónico sobre ABC y resúmalo
Escribe una bonita respuesta al último correo electrónico de Alice y carga un borrador.
Responda al correo electrónico de Bob con una nota de agradecimiento. Guárdelo como borrador.
¿Qué tengo en mi agenda mañana?
Consulta la agenda familiar de mi cuenta privada para la próxima semana
Necesito organizar un evento con Tim de dos horas la semana que viene. ¿Podrías sugerirme algunos horarios?

Inicio rápido

Instalar

Instalación mediante herrería

Para instalar mcp-gsuite para Claude Desktop automáticamente a través de 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:

Crear credenciales OAuth2:
- Vaya a la consola de Google Cloud
- Crea un nuevo proyecto o selecciona 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.
- Configurar la pantalla de consentimiento de OAuth con la información requerida
- Agregar URI de redireccionamiento autorizados (incluya http://localhost:4100/code para desarrollo local)
Ámbitos OAuth2 requeridos:

   [
     "openid",
     "https://mail.google.com/",
     "https://www.googleapis.com/auth/calendar",
     "https://www.googleapis.com/auth/userinfo.email"
   ]

Luego crea un .gauth.json en tu 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"
    }
}

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'"
        }
    ]
}

Puedes especificar varias cuentas. Asegúrate de que tengan acceso a tu aplicación Google Auth. El campo extra_info es especialmente interesante, ya que puedes añadir aquí información que quieras compartir con la IA sobre la cuenta (por ejemplo, si tiene una agenda específica).

Nota: Al ejecutar por primera vez una de las herramientas para una cuenta específica, se abrirá un navegador que lo redirigirá a Google y le solicitará sus credenciales, alcance, etc. Tras iniciar sesión correctamente, las credenciales se almacenan en un archivo local llamado .oauth.{email}.json . Una vez autorizado, se utilizará el token de actualización.

Escritorio de Claude

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"
      ]
    }
  }
}

Nota: También puede utilizar uv run mcp-gsuite --accounts-file /path/to/custom/.accounts.json para especificar un archivo de cuentas diferente o --credentials-dir /path/to/custom/credentials para especificar un directorio de credenciales diferente.

{
  "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 y la información de la cuenta:

--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 de OAuth tras 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, lo que resulta 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 varias instancias del servidor ejecutándose con diferentes configuraciones o cuando se implementa en entornos donde las rutas predeterminadas no son adecuadas.

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

Distribuciones de paquetes de compilación:

uv build

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

Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores 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 en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

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

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

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

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

mcp-gsuite

Integrations