Headless Gmail MCP Server

Wat doet de “Headless Gmail” MCP Server?

De Headless Gmail MCP Server is een Model Context Protocol (MCP) server die naadloze interactie met Gmail-accounts mogelijk maakt voor het verzenden en ophalen van e-mails, alles zonder de noodzaak van lokale credential- of tokeninstellingen. Ontworpen voor headless en externe werking, stelt het clients in staat om zelfstandig OAuth-flows te voltooien en credentials veilig als context door te geven, waardoor het mogelijk is om volledig in containers of cloudomgevingen te draaien zonder lokale bestands- of browsertoegang. Deze server is ideaal voor workflows die gerichte, betrouwbare Gmail-toegang vereisen—zoals marketingautomatisering of notificatiesystemen—door gestandaardiseerde tools via de MCP-interface aan te bieden voor e-mailbeheer en integratie in AI-ontwikkelpijplijnen.

Lijst van Prompts

Er worden geen specifieke prompt-templates genoemd in de repository.

Lijst van Resources

Er worden geen expliciete MCP-resources beschreven in de beschikbare documentatie of code.

Lijst van Tools

• Recente e-mails ophalen
  Haalt de meest recente e-mails op uit een Gmail-account en geeft de eerste 1.000 tekens van de e-mailtekst terug.
• Volledige e-mailtekst ophalen
  Haalt de volledige inhoud van een e-mail op in stukken van 1.000 tekens via een offset-parameter, waardoor grote e-mails opgehaald kunnen worden.
• E-mail verzenden
  Verstuurd e-mails via het gekoppelde Gmail-account.
• Toegangstoken vernieuwen
  Beheert tokenvernieuwingen zelfstandig voor voortdurende, veilige toegang.

Gebruiksscenario’s van deze MCP Server

• Geautomatiseerde E-mailnotificaties
  Integreer met AI-agenten of automatiseringsplatforms om realtime e-mailalerts of notificaties te versturen zonder handmatige tussenkomst.
• Gmail Inbox Monitoring
  Haal de nieuwste e-mails op en verwerk ze om reacties te automatiseren, te triageren of informatie te extraheren voor vervolgworkflows.
• Automatisering van Marketingcampagnes
  Verstuur gepersonaliseerde marketingmails programmatisch door MCP te benutten voor schaalbare, van credentials gescheiden campagne-uitvoering.
• Naadloze API-integratie
  Integreer Gmail-operaties in ontwikkelomgevingen of andere MCP-compatibele platforms zonder lokale credentials bloot te stellen of te beheren.
• Extern/Cloud E-mailbeheer
  Beheer Gmail-accounts binnen Dockerized of externe omgevingen voor veilige, headless werking zonder lokale afhankelijkheden.

Hoe stel je het in

Windsurf

1. Zorg dat je Node.js en Windsurf hebt geïnstalleerd.
2. Open je configuratiebestand (bijv. windsurf.json).
3. Voeg de Headless Gmail MCP Server toe aan het mcpServers-gedeelte:

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

4. Sla de wijzigingen op en herstart Windsurf.
5. Controleer of de server draait via het Windsurf-dashboard.

API-sleutels beveiligen
Gebruik omgevingsvariabelen om credentials veilig door te geven:

{
  "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. Installeer Claude en zorg dat Node.js beschikbaar is.
2. Bewerk het configuratiebestand (bijv. claude.json).
3. Voeg de server toe:

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

4. Sla op en herstart Claude.
5. Controleer de serverstatus in de Claude-interface.

API-sleutels beveiligen
Gebruik de env-sleutel zoals hierboven om credentials veilig toe te voegen.

Cursor

1. Zorg dat Cursor is geïnstalleerd en up-to-date is.
2. Open de instellingen of het configuratiebestand van Cursor.
3. Voeg de MCP-server toe:

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

4. Sla op en herstart Cursor.
5. Controleer of de MCP-server is herkend.

API-sleutels beveiligen
Configureer credentials via de env-sectie zoals eerder getoond.

Cline

1. Installeer Cline en afhankelijkheden.
2. Open het configuratiebestand van Cline.
3. Voeg de MCP-server toe:

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

4. Sla wijzigingen op en herstart Cline.
5. Controleer de serververbinding via de tools van Cline.

API-sleutels beveiligen
Geef API-credentials door via omgevingsvariabelen in de configuratie zoals in eerdere voorbeelden.

Hoe gebruik je deze MCP in flows

MCP gebruiken in FlowHunt

Om MCP-servers in je FlowHunt-workflow te integreren, voeg je het MCP-component toe aan je flow en verbind je deze met je AI-agent:

Klik op het MCP-component om het configuratiepaneel te openen. Voeg in het systeem-MCP-configuratiegedeelte je MCP-servergegevens toe in dit JSON-formaat:

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

Eenmaal geconfigureerd kan de AI-agent deze MCP nu als tool gebruiken met toegang tot alle functies en mogelijkheden. Vergeet niet “headless-gmail” te vervangen door de daadwerkelijke naam van je MCP-server (bijv. “github-mcp”, “weather-api”, enz.) en de URL te vervangen door die van jouw eigen MCP-server.

Overzicht

Onze mening

Op basis van de beschikbare informatie is de Headless Gmail MCP Server zeer gericht en eenvoudig te integreren, met duidelijke instructies voor de meeste platforms en robuuste Docker/headless-ondersteuning. Er ontbreken echter expliciete prompt-templates en resource-definities, wat sommige geavanceerde MCP-functionaliteiten kan beperken. De kracht ligt in eenvoud, veiligheid en praktische bruikbaarheid voor e-mailgerichte automatisering. Al met al is het een praktische en betrouwbare oplossing voor het beoogde gebruik, maar iets minder compleet qua features dan sommige andere MCP-servers.

MCP Score