Headless Gmail MCP Server

Čo robí „Headless Gmail“ MCP Server?

Headless Gmail MCP Server je server Model Context Protocol (MCP), ktorý umožňuje bezproblémovú interakciu s Gmail účtami na odosielanie a prijímanie emailov bez potreby lokálneho nastavenia poverení alebo tokenov. Navrhnutý pre bezhlavú a vzdialenú prevádzku, umožňuje klientom dokončiť OAuth toky nezávisle a bezpečne prenášať poverenia ako kontext, čím je možné bežať v plne kontajnerizovanom alebo cloudovom prostredí bez lokálneho prístupu k súborom alebo interakcie s prehliadačom. Tento server je ideálny pre workflowy, ktoré potrebujú zameraný, spoľahlivý prístup k Gmailu – ako je marketingová automatizácia alebo notifikačné systémy – tým, že poskytuje štandardizované nástroje cez MCP rozhranie na správu emailov a integráciu do AI-powered vývojových pipeline.

Zoznam promptov

V repozitári nie sú spomenuté žiadne konkrétne šablóny promptov.

Zoznam zdrojov

V dostupnej dokumentácii alebo kóde nie sú explicitne popísané MCP zdroje.

Zoznam nástrojov

• Získať najnovšie emaily
  Získa najnovšie emaily z Gmail účtu, vracia prvých 1 000 znakov tela emailu.
• Získať celé telo emailu
  Načíta celý obsah emailu v 1 000-znakových blokoch pomocou offset parametra, čo umožňuje sťahovanie veľkých emailov.
• Odoslať email
  Odošle emaily prostredníctvom prepojeného Gmail účtu.
• Obnoviť prístupový token
  Samostatne spravuje obnovu tokenov, čím zabezpečuje nepretržitý bezpečný prístup.

Príklady použitia tohto MCP servera

• Automatizované emailové notifikácie
  Integrujte s AI agentmi alebo automatizačnými platformami na odosielanie emailových upozornení či notifikácií v reálnom čase bez ručného zásahu.
• Monitorovanie Gmail inboxu
  Načítavajte a spracovávajte najnovšie emaily na automatizovanú odpoveď, triedenie alebo extrakciu informácií pre ďalšie workflowy.
• Automatizácia marketingových kampaní
  Programovo odosielajte personalizované marketingové emaily, využívajúc MCP pre škálovateľnú, oddelenú správu poverení kampaní.
• Bezproblémová API integrácia
  Zaintegtrujte Gmail operácie do vývojárskych prostredí alebo iných MCP-aware platforiem bez vystavovania alebo správy lokálnych poverení.
• Vzdialená/cloudová správa emailov
  Spravujte Gmail účty v Docker alebo vzdialených prostrediach, čo umožňuje bezpečnú, bezhlavú prevádzku bez lokálnych závislostí.

Ako nastaviť

Windsurf

1. Uistite sa, že máte nainštalované Node.js a Windsurf.
2. Otvorte konfiguračný súbor (napr. windsurf.json).
3. Pridajte Headless Gmail MCP Server do sekcie mcpServers:

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

4. Uložte zmeny a reštartujte Windsurf.
5. Overte, že server beží cez Windsurf dashboard.

Zabezpečenie API kľúčov
Na bezpečné prenášanie poverení použite environmentálne premenné:

{
  "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. Nainštalujte Claude a uistite sa, že máte Node.js.
2. Upravte konfiguračný súbor (napr. claude.json).
3. Pridajte server:

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

4. Uložte a reštartujte Claude.
5. Skontrolujte stav servera v rozhraní Claude.

Zabezpečenie API kľúčov
Na bezpečné vloženie poverení použite kľúč env ako vyššie.

Cursor

1. Uistite sa, že je Cursor nainštalovaný a aktuálny.
2. Otvorte nastavenia alebo konfiguračný súbor Cursoru.
3. Vložte MCP server:

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

4. Uložte a reštartujte Cursor.
5. Overte, že MCP server je rozpoznaný.

Zabezpečenie API kľúčov
Nastavte poverenia cez sekciu env ako vo vyššie uvedených príkladoch.

Cline

1. Nainštalujte Cline a závislosti.
2. Otvorte konfiguračný súbor Cline.
3. Pridajte MCP server:

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

4. Uložte zmeny a reštartujte Cline.
5. Overte konektivitu servera cez nástroje Cline.

Zabezpečenie API kľúčov
Prenášajte API poverenia cez environmentálne premenné v konfigurácii ako v predchádzajúcich príkladoch.

Ako používať tento MCP vo flow

Použitie MCP vo FlowHunt

Na integráciu MCP serverov do vášho FlowHunt workflow, začnite pridaním MCP komponentu do flow a jeho prepojením s vaším AI agentom:

Kliknite na MCP komponent pre otvorenie konfiguračného panela. V sekcii systémovej MCP konfigurácie vložte detail vášho MCP servera v tomto JSON formáte:

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

Po nakonfigurovaní môže AI agent používať tento MCP ako nástroj so všetkými jeho funkciami a schopnosťami. Nezabudnite zmeniť “headless-gmail” na skutočný názov vášho MCP servera (napr. “github-mcp”, “weather-api” atď.) a vymeniť URL za vlastnú adresu MCP servera.

Prehľad

Náš názor

Na základe dostupných informácií je Headless Gmail MCP Server vysoko zameraný a jednoducho integrovaný, s jasnými inštrukciami pre väčšinu platforiem a robustnou podporou pre Docker a bezhlavú prevádzku. Chýbajú mu však explicitné šablóny promptov a definície zdrojov, čo môže obmedziť niektoré pokročilé MCP funkcie. Jeho silné stránky sú jednoduchosť, bezpečnosť a praktická využiteľnosť pre automatizáciu súvisiacu s emailami. Celkovo je praktický a spoľahlivý pre svoj účel, hoci nie je tak funkčne kompletný ako niektoré iné MCP servery.

MCP skóre