Servidor Headless Gmail MCP

¿Qué hace el Servidor “Headless Gmail” MCP?

El Servidor Headless Gmail MCP es un servidor Model Context Protocol (MCP) que facilita la interacción fluida con cuentas de Gmail para enviar y recibir correos electrónicos, todo sin necesidad de configurar credenciales o tokens localmente. Diseñado para operación sin interfaz y remota, permite que los clientes completen flujos OAuth de manera independiente y pasen credenciales de forma segura como contexto, posibilitando su ejecución en entornos completamente en contenedores o en la nube, sin acceso local a archivos o interacción con navegador. Este servidor es ideal para flujos de trabajo que requieren acceso a Gmail enfocado y confiable—como la automatización de marketing o sistemas de notificaciones—exponiendo herramientas estandarizadas a través de la interfaz MCP para la gestión de email e integración en pipelines de desarrollo impulsados por IA.

Lista de Prompts

No se mencionan plantillas de prompt específicas en el repositorio.

Lista de Recursos

No se describen recursos MCP explícitos en la documentación o código disponible.

Lista de Herramientas

• Obtener emails recientes
  Recupera los emails más recientes de una cuenta de Gmail, devolviendo los primeros 1,000 caracteres del cuerpo del email.
• Obtener cuerpo completo del email
  Obtiene el contenido completo de un email en fragmentos de 1,000 caracteres usando un parámetro de desplazamiento, permitiendo la recuperación de emails grandes.
• Enviar email
  Envía correos electrónicos a través de la cuenta de Gmail conectada.
• Refrescar token de acceso
  Gestiona la renovación de tokens de forma independiente para asegurar el acceso seguro y continuo.

Casos de Uso de este Servidor MCP

• Notificaciones de Email Automatizadas
  Integra con agentes de IA o plataformas de automatización para enviar alertas o notificaciones de email en tiempo real sin intervención manual.
• Monitoreo de Bandeja de Entrada Gmail
  Recupera y procesa los emails más recientes para automatizar respuestas, clasificación o extraer información para flujos de trabajo posteriores.
• Automatización de Campañas de Marketing
  Envía emails de marketing personalizados de forma programática, aprovechando MCP para campañas escalables y separadas por credenciales.
• Integración API Fluida
  Incorpora operaciones de Gmail en entornos de desarrollo u otras plataformas compatibles con MCP sin exponer ni gestionar credenciales locales.
• Gestión de Email Remota/Cloud
  Administra cuentas de Gmail dentro de entornos Dockerizados o remotos, permitiendo operación segura y sin interfaz local.

Cómo configurarlo

Windsurf

1. Asegúrate de tener Node.js y Windsurf instalados.
2. Abre tu archivo de configuración (por ejemplo, windsurf.json).
3. Añade el Servidor Headless Gmail MCP a la sección mcpServers:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Guarda los cambios y reinicia Windsurf.
5. Verifica que el servidor esté en ejecución desde el panel de Windsurf.

Protegiendo las claves API
Utiliza variables de entorno para pasar credenciales de forma segura:

{
  "mcpServers": {
    "headless-gmail": {
      "command": "npx",
      "args": ["@baryhuang/mcp-headless-gmail@latest"],
      "env": {
        "GMAIL_CLIENT_ID": "...",
        "GMAIL_CLIENT_SECRET": "...",
        "GMAIL_ACCESS_TOKEN": "...",
        "GMAIL_REFRESH_TOKEN": "..."
      }
    }
  }
}

Claude

1. Instala Claude y asegúrate de que Node.js esté disponible.
2. Edita el archivo de configuración (por ejemplo, claude.json).
3. Añade el servidor:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Guarda y reinicia Claude.
5. Comprueba el estado del servidor en la interfaz de Claude.

Protegiendo las claves API
Utiliza la clave env como en el ejemplo anterior para inyectar credenciales de forma segura.

Cursor

1. Asegúrate de tener Cursor instalado y actualizado.
2. Abre la configuración o archivo de ajustes de Cursor.
3. Inserta la entrada del servidor MCP:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Guarda y reinicia Cursor.
5. Confirma que el servidor MCP es detectado.

Protegiendo las claves API
Configura las credenciales usando la sección env como se mostró anteriormente.

Cline

1. Instala Cline y sus dependencias.
2. Abre el archivo de configuración de Cline.
3. Añade el servidor MCP:

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. Guarda los cambios y reinicia Cline.
5. Asegúrate de la conectividad del servidor a través de las herramientas de Cline.

Protegiendo las claves API
Pasa las credenciales API usando variables de entorno en la configuración, tal como en los ejemplos anteriores.

Cómo usar este MCP dentro de flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo FlowHunt, comienza añadiendo el componente MCP a tu flujo y conectándolo a tu agente de IA:

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración de MCP del sistema, inserta los detalles de tu servidor MCP usando este formato JSON:

{
  "headless-gmail": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Una vez configurado, el agente de IA podrá usar este MCP como una herramienta con acceso a todas sus funciones y capacidades. Recuerda cambiar “headless-gmail” por el nombre real de tu servidor MCP (por ejemplo, “github-mcp”, “weather-api”, etc.) y reemplazar la URL por la de tu propio servidor MCP.

Resumen

Nuestra opinión

Según la información disponible, el Servidor Headless Gmail MCP tiene un enfoque claro y es fácil de integrar, con instrucciones claras para la mayoría de plataformas y buen soporte para Docker/headless. Sin embargo, carece de plantillas de prompt explícitas y definiciones de recursos, lo que puede limitar algunas funciones avanzadas de MCP. Sus fortalezas son la simplicidad, la seguridad y la utilidad real para automatización centrada en email. En general, es práctico y fiable para su propósito, aunque no tan completo en características como otros servidores MCP.

Puntuación MCP