Headless Gmail MCP Server

Was macht der “Headless Gmail” MCP Server?

Der Headless Gmail MCP Server ist ein Model Context Protocol (MCP) Server, der eine nahtlose Interaktion mit Gmail-Konten zum Senden und Abrufen von E-Mails ermöglicht – ganz ohne lokale Anmeldedaten- oder Token-Einrichtung. Entwickelt für kopflose und entfernte Nutzung, erlaubt er es Clients, OAuth-Flows unabhängig abzuschließen und Anmeldedaten sicher als Kontext zu übergeben. So ist der Betrieb in vollständig containerisierten oder Cloud-Umgebungen ohne lokalen Dateizugriff oder Browserinteraktion möglich. Dieser Server eignet sich ideal für Workflows, die gezielten, zuverlässigen Gmail-Zugriff benötigen – etwa für Marketing-Automatisierung oder Benachrichtigungssysteme – indem er standardisierte Tools über die MCP-Schnittstelle zur E-Mail-Verwaltung und Integration in KI-gestützte Entwicklungspipelines bereitstellt.

Liste der Prompts

Keine spezifischen Prompt-Vorlagen im Repository erwähnt.

Liste der Ressourcen

Keine expliziten MCP-Ressourcen in der verfügbaren Dokumentation oder im Code beschrieben.

Liste der Tools

• Aktuelle E-Mails abrufen
  Ruft die neuesten E-Mails aus einem Gmail-Konto ab und gibt die ersten 1.000 Zeichen des E-Mail-Inhalts zurück.
• Vollständigen E-Mail-Inhalt abrufen
  Holt den kompletten Inhalt einer E-Mail in 1.000-Zeichen-Abschnitten mittels Offset-Parameter – ideal für große E-Mails.
• E-Mail versenden
  Versendet E-Mails über das verbundene Gmail-Konto.
• Zugriffstoken aktualisieren
  Handhabt Token-Aktualisierungen selbstständig und gewährleistet so fortlaufenden sicheren Zugriff.

Anwendungsfälle dieses MCP-Servers

• Automatisierte E-Mail-Benachrichtigungen
  Integration mit KI-Agenten oder Automatisierungsplattformen, um E-Mail-Benachrichtigungen in Echtzeit zu senden – ganz ohne manuelles Eingreifen.
• Gmail-Posteingangsüberwachung
  Abrufen und Verarbeiten der neuesten E-Mails zur Automatisierung von Antworten, Priorisierung oder Extraktion von Informationen für nachgelagerte Workflows.
• Marketing-Kampagnen-Automatisierung
  Versand personalisierter Marketing-E-Mails programmatisch, mit MCP für skalierbare, anmeldegetrennte Kampagnen-Ausführung.
• Nahtlose API-Integration
  Gmail-Operationen in Entwicklerumgebungen oder andere MCP-fähige Plattformen einbinden, ohne lokale Anmeldedaten zu exponieren oder zu verwalten.
• Remote/Cloud E-Mail-Management
  Gmail-Konten in Docker- oder Remote-Setups verwalten – sicher, kopflos und ohne lokale Abhängigkeiten.

Einrichtung

Windsurf

1. Stellen Sie sicher, dass Node.js und Windsurf installiert sind.
2. Öffnen Sie Ihre Konfigurationsdatei (z. B. windsurf.json).
3. Fügen Sie den Headless Gmail MCP Server im Bereich mcpServers hinzu:

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

4. Änderungen speichern und Windsurf neu starten.
5. Überprüfen Sie den Serverstatus im Windsurf-Dashboard.

API-Schlüssel absichern
Verwenden Sie Umgebungsvariablen, um Anmeldedaten sicher zu übergeben:

{
  "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. Installieren Sie Claude und stellen Sie sicher, dass Node.js verfügbar ist.
2. Bearbeiten Sie die Konfigurationsdatei (z. B. claude.json).
3. Fügen Sie den Server hinzu:

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

4. Speichern und Claude neu starten.
5. Serverstatus in der Claude-Oberfläche prüfen.

API-Schlüssel absichern
Nutzen Sie wie oben den env-Schlüssel, um Anmeldedaten sicher einzubinden.

Cursor

1. Stellen Sie sicher, dass Cursor installiert und aktuell ist.
2. Öffnen Sie die Einstellungen oder Konfigurationsdatei von Cursor.
3. Tragen Sie den MCP-Server-Eintrag ein:

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

4. Speichern und Cursor neu starten.
5. Überprüfen, ob der MCP-Server erkannt wird.

API-Schlüssel absichern
Konfigurieren Sie die Anmeldedaten wie zuvor im Abschnitt env.

Cline

1. Installieren Sie Cline und die nötigen Abhängigkeiten.
2. Öffnen Sie die Cline-Konfigurationsdatei.
3. Fügen Sie den MCP-Server hinzu:

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

4. Änderungen speichern und Cline neu starten.
5. Server-Konnektivität über Clines Tools sicherstellen.

API-Schlüssel absichern
Übergeben Sie die API-Anmeldedaten via Umgebungsvariablen wie in den vorherigen Beispielen.

Verwendung dieses MCP in Flows

MCP in FlowHunt verwenden

Um MCP-Server in Ihren FlowHunt-Workflow zu integrieren, fügen Sie zunächst die MCP-Komponente zu Ihrem Flow hinzu und verbinden Sie diese mit Ihrem KI-Agenten:

Klicken Sie auf die MCP-Komponente, um das Konfigurationsmenü zu öffnen. Im Bereich System-MCP-Konfiguration tragen Sie die Details Ihres MCP-Servers in folgendem JSON-Format ein:

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

Nach der Konfiguration kann der KI-Agent dieses MCP als Tool mit Zugriff auf alle Funktionen und Möglichkeiten nutzen. Denken Sie daran, “headless-gmail” ggf. durch den tatsächlichen Namen Ihres MCP-Servers (z. B. “github-mcp”, “weather-api” etc.) zu ersetzen und die URL mit Ihrer eigenen MCP-Server-URL zu überschreiben.

Übersicht

Unsere Meinung

Nach den verfügbaren Informationen ist der Headless Gmail MCP Server sehr fokussiert und leicht zu integrieren, mit klaren Anleitungen für die meisten Plattformen sowie umfassender Docker-/Headless-Unterstützung. Es fehlen jedoch explizite Prompt-Vorlagen und Ressourcendefinitionen, was einige fortgeschrittene MCP-Features einschränken könnte. Seine Stärken liegen in Einfachheit, Sicherheit und Praxistauglichkeit für die E-Mail-orientierte Automatisierung. Insgesamt ist er für den vorgesehenen Einsatzzweck praktisch und zuverlässig, aber im Vergleich zu manchen anderen MCP-Servern nicht ganz so funktionsreich.

MCP Score