Servidor MCP de Gmail

Un servidor MCP (Protocolo de contexto de modelo) que proporciona capacidades de integración de Gmail a clientes MCP como Claude Desktop.

Características

• Ver correos electrónicos recientes desde tu bandeja de entrada de Gmail

• Buscar correos electrónicos usando la sintaxis de búsqueda de Gmail

• Autenticación segura de OAuth2 con la API de Gmail

Related MCP server: Gmail MCP

Configuración

1. Configuración del proyecto de Google Cloud

1. Crea un proyecto de Google Cloud en https://console.cloud.google.com/

2. Habilitar la API de Gmail

3. Crear credenciales OAuth 2.0:

   • Tipo de aplicación: Aplicación de escritorio

   • Descargue las credenciales como credentials.json

2. Instalación

# Create a conda environment
conda create -n mcp-gmail python=3.12
conda activate mcp-gmail

# Install the package
cd gmail-mcp-server
pip install -e .

3. Configuración para Claude Desktop

Añade a tu claude_desktop_config.json :

{
  "mcpServers": {
    "gmail": {
      "command": "/path/to/conda/envs/mcp-gmail/bin/python",
      "args": ["-m", "gmail_mcp_server.server"],
      "env": {
        "PYTHONPATH": "/path/to/gmail-mcp-server/src",
        "GMAIL_CREDENTIALS_FILE": "/path/to/credentials.json",
        "GMAIL_TOKEN_FILE": "/path/to/token.json"
      }
    }
  }
}

Reemplace /path/to/ con sus rutas actuales. El archivo de token se creará automáticamente al autenticarse por primera vez.

4. Primera ejecución

La primera vez que intentes acceder a Gmail a través de Claude, se te solicitará que autorices la aplicación en tu navegador. Tras la autorización, tus credenciales se guardarán en el archivo de token para su uso posterior.

Recursos disponibles

• gmail://inbox/recent - Devuelve sus 10 correos electrónicos más recientes

Herramientas disponibles

• search_emails

  • Descripción: Busca correos electrónicos de Gmail con una consulta

  • Parámetros:

    • query (obligatoria): consulta de búsqueda de Gmail (utiliza la sintaxis de búsqueda estándar de Gmail)

    • max_results (opcional): Número máximo de resultados a devolver (predeterminado: 10)

Ejemplo de búsqueda:

Could you show me any emails from sanrio in the last two days?

Seguridad

Este servidor requiere autenticación OAuth2 con Gmail:

• Se le solicitará que autorice el acceso en su navegador la primera vez que lo use.

• Las credenciales se almacenan localmente en el archivo de token especificado

• El acceso se puede revocar en cualquier momento a través de la configuración de su cuenta de Google.

• Solo se solicita acceso de lectura a Gmail (no permisos de escritura)

Variables de entorno

• GMAIL_CREDENTIALS_FILE (obligatorio): Ruta a su archivo de credenciales de Google OAuth

• GMAIL_TOKEN_FILE (obligatorio): Ruta donde se guardará el token de autenticación

Para realizar pruebas, puede ejecutar el servidor directamente:

GMAIL_CREDENTIALS_FILE="/path/to/credentials.json" \
GMAIL_TOKEN_FILE="/path/to/token.json" \
python -m gmail_mcp_server.server

Desarrollo

El servidor utiliza el Protocolo de Contexto de Modelo para proporcionar:

• Acceso a recursos a correos electrónicos recientes

• Soporte de herramientas para búsqueda de correo electrónico

• Flujo de autenticación segura de OAuth2

• Actualización automática del token

Explotación florestal

El servidor registra información detallada sobre sus operaciones en stderr, incluyendo:

• Información de inicio del servidor

• Estado de autenticación

• Uso de recursos y herramientas

• Cualquier error o problema

Contribuyendo

¡Las solicitudes de extracción son bienvenidas! Por favor, asegúrese de:

• Actualizar la documentación para cualquier característica nueva

• Añadir un manejo de errores adecuado

• Pruebe el flujo de OAuth con nuevas funciones

• Seguir el estilo de código existente