Headless Gmail MCP Server

K čemu slouží “Headless Gmail” MCP Server?

Headless Gmail MCP Server je server Model Context Protocol (MCP), který umožňuje bezproblémovou interakci s účty Gmail pro odesílání a stahování e-mailů, a to bez nutnosti lokálního nastavení přihlašovacích údajů či tokenů. Je navržen pro bezhlavý a vzdálený provoz, klientům umožňuje dokončit OAuth procesy nezávisle a bezpečně předávat přihlašovací údaje jako kontext, což umožňuje provoz v plně kontejnerizovaných nebo cloudových prostředích bez přístupu k lokálním souborům či prohlížeči. Tento server je ideální pro workflow, která potřebují spolehlivý přístup ke Gmailu – například automatizace marketingu nebo notifikací – a to díky zpřístupnění standardizovaných nástrojů prostřednictvím MCP rozhraní pro správu e-mailů a integraci do AI vývojových pipeline.

Seznam výzev (Prompts)

V repozitáři nejsou uvedeny žádné konkrétní šablony výzev.

Seznam zdrojů

V dostupné dokumentaci ani kódu nejsou popsány explicitní MCP zdroje.

Seznam nástrojů

• Získat nejnovější e-maily
  Načte nejnovější e-maily z účtu Gmail a vrátí prvních 1 000 znaků těla e-mailu.
• Získat celé tělo e-mailu
  Stáhne celý obsah e-mailu po 1 000 znacích pomocí offset parametru, což umožňuje stahovat i dlouhé zprávy.
• Odeslat e-mail
  Odešle e-mail prostřednictvím připojeného Gmail účtu.
• Obnovit access token
  Samostatně spravuje obnovu tokenu, čímž zajišťuje trvalý, bezpečný přístup.

Příklady použití tohoto MCP serveru

• Automatizovaná e-mailová upozornění
  Integrace s AI agenty nebo automatizačními platformami pro odesílání e-mailových upozornění či notifikací v reálném čase bez ručního zásahu.
• Monitoring Gmail inboxu
  Stahujte a zpracovávejte nejnovější e-maily pro automatickou odpověď, třídění nebo extrakci informací pro navazující workflow.
• Automatizace marketingových kampaní
  Programově odesílejte personalizované marketingové e-maily s využitím MCP pro škálovatelné a oddělené exekuce kampaní.
• Bezproblémová API integrace
  Zahrňte Gmail operace do vývojářského prostředí nebo jiných MCP-aware platforem bez vystavování či správy lokálních přihlašovacích údajů.
• Vzdálená/cloudová správa e-mailů
  Spravujte Gmail účty v Dockeru či vzdálených prostředích, umožňující bezpečný bezhlavý provoz bez lokálních závislostí.

Jak nastavit

Windsurf

1. Ujistěte se, že máte nainstalovaný Node.js a Windsurf.
2. Otevřete svůj konfigurační soubor (např. windsurf.json).
3. Přidejte Headless Gmail MCP Server do sekce mcpServers:

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

4. Uložte změny a restartujte Windsurf.
5. Ověřte běh serveru přes Windsurf dashboard.

Zabezpečení API klíčů
Použijte environmentální proměnné pro bezpečné předávání přihlašovacích údajů:

{
  "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. Nainstalujte Claude a ujistěte se, že je dostupný Node.js.
2. Upravte konfigurační soubor (např. claude.json).
3. Přidejte server:

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

4. Uložte a restartujte Claude.
5. Zkontrolujte stav serveru v rozhraní Claude.

Zabezpečení API klíčů
Použijte klíč env stejně jako výše pro bezpečné vložení přihlašovacích údajů.

Cursor

1. Ujistěte se, že máte nainstalovaný a aktuální Cursor.
2. Otevřete nastavení nebo konfigurační soubor Cursoru.
3. Vložte MCP server položku:

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

4. Uložte a restartujte Cursor.
5. Potvrďte detekci MCP serveru.

Zabezpečení API klíčů
Nastavte přihlašovací údaje pomocí sekce env, jak je uvedeno výše.

Cline

1. Nainstalujte Cline a závislosti.
2. Otevřete konfigurační soubor Cline.
3. Přidejte MCP server:

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

4. Uložte změny a restartujte Cline.
5. Ověřte konektivitu serveru pomocí nástrojů Cline.

Zabezpečení API klíčů
Předávejte API přihlašovací údaje prostřednictvím environmentálních proměnných v konfiguraci jako v předchozích příkladech.

Jak použít tento MCP uvnitř toků

Použití MCP ve FlowHunt

Pro integraci MCP serveru do svého workflow ve FlowHunt začněte přidáním MCP komponenty do toku a propojte ji se svým AI agentem:

Klikněte na MCP komponentu pro otevření konfiguračního panelu. V sekci systémové MCP konfigurace vložte údaje o vašem MCP serveru v tomto JSON formátu:

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

Po konfiguraci může AI agent používat tento MCP jako nástroj se všemi jeho funkcemi. Nezapomeňte změnit “headless-gmail” na skutečný název vašeho MCP serveru (např. “github-mcp”, “weather-api” apod.) a nahradit URL adresou vašeho MCP serveru.

Přehled

Náš názor

Na základě dostupných informací je Headless Gmail MCP Server velmi zaměřený a snadno integrovatelný, s jasnými návody pro většinu platforem a robustní podporou Dockeru/bezhlavého provozu. Na druhou stranu mu chybí explicitní šablony výzev a definice zdrojů, což může limitovat některé pokročilé MCP funkce. Jeho silnou stránkou je jednoduchost, bezpečnost a praktická použitelnost pro automatizaci zaměřenou na e-maily. Celkově je praktický a spolehlivý pro určené použití, ale není tak funkčně kompletní jako některé jiné MCP servery.

MCP skóre