Integrace Gmail MCP Serveru

Co dělá “Gmail” MCP Server?

Gmail MCP Server je server Model Context Protocol (MCP) navržený pro integraci funkcí Gmailu do AI platforem, jako je Claude Desktop. Jeho hlavní úlohou je sloužit jako most mezi AI asistenty a Gmailem, což umožňuje ovládání e-mailů přirozeným jazykem. To zahrnuje odesílání a čtení e-mailů, správu štítků, práci s přílohami, vyhledávání konkrétních zpráv a provádění hromadných operací. Díky zpřístupnění těchto schopností jako MCP nástrojů a zdrojů umožňuje Gmail MCP Server vývojářům vytvářet silné workflow, v nichž AI agenti mohou automatizovat a zefektivnit správu e-mailů, usnadnit kontextové získávání dat z doručené pošty a programově manipulovat s obsahem Gmailu – to vše s využitím bezpečné autentifikace přes OAuth2.

Seznam promptů

V repozitáři nebo dokumentaci nejsou uvedeny žádné explicitní šablony promptů.

Seznam zdrojů

• E-mailové zprávy
  Zpřístupňuje e-mailové zprávy jako zdroje, které mohou být načteny a použity jako kontext pro interakce s LLM.

• Gmail štítky
  Poskytuje přístup k systémovým i uživatelsky definovaným štítkům Gmailu, které lze použít pro organizaci nebo vyhledání e-mailů.

• Metadata příloh
  Umožňuje získání informací o přílohách e-mailů, jako jsou názvy souborů, typy a velikosti.

• Výsledky vyhledávání
  Umožňuje klientům přistupovat k výsledkům pokročilého vyhledávání e-mailů podle předmětu, odesílatele nebo časového rozsahu.

Seznam nástrojů

Na základě funkcí popsaných v dokumentaci poskytuje Gmail MCP Server tyto nástroje:

• send_email
  Odesílání e-mailů s předmětem, obsahem, přílohami a příjemci, včetně podpory HTML a mezinárodních znaků.

• read_email
  Načítání e-mailových zpráv podle ID s podporou komplexních MIME struktur.

• list_labels
  Výpis všech dostupných Gmail štítků (systémových i uživatelských).

• manage_labels
  Vytváření, aktualizace, mazání a výpis štítků pro komplexní správu štítků.

• search_emails
  Vyhledávání e-mailů podle různých kritérií (předmět, odesílatel, časový rozsah).

• list_emails_by_label
  Výpis e-mailů v doručené poště, odeslané poště nebo v uživatelsky definovaných štítcích.

• mark_read_unread
  Označení e-mailů jako přečtených nebo nepřečtených.

• move_email
  Přesun e-mailů do různých štítků/složek.

• delete_email
  Odstranění e-mailů ze schránky.

• batch_operations
  Efektivní zpracování více e-mailů najednou hromadnými operacemi.

Příklady využití tohoto MCP Serveru

• Automatizované odesílání e-mailů
  Vývojáři mohou nastavit workflow, kde AI agenti automaticky sestavují a odesílají e-maily, což snižuje ruční práci při rutinní komunikaci.

• Třídění a správa doručené pošty
  AI asistenti mohou kategorizovat, označovat a přesouvat e-maily do příslušných složek, čímž pomáhají uživatelům udržovat organizovanou schránku a prioritizovat důležité zprávy.

• Vyhledávání a získávání e-mailů
  Díky pokročilým vyhledávacím kritériím mohou uživatelé rychle najít konkrétní zprávy nebo přílohy a zefektivnit získávání informací z Gmailu.

• Hromadné zpracování
  Hromadné operace, jako je mazání, označování jako přečtené/nepřečtené nebo přesouvání skupin e-mailů, lze automatizovat, což ušetří čas uživatelům s velkým objemem pošty.

• Automatizace správy štítků
  AI může dynamicky vytvářet, aktualizovat nebo mazat štítky v Gmailu, což umožňuje adaptivní organizační strategie podle měnících se potřeb uživatele nebo projektu.

Jak nastavit

Windsurf

1. Ujistěte se, že jsou splněny předpoklady jako je instalace Node.js.
2. Otevřete konfigurační soubor Windsurf (obvykle windsurf.json nebo podobný).
3. Přidejte balíček Gmail MCP Server:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

4. Uložte konfiguraci a restartujte Windsurf.
5. Ověřte nastavení tak, že zkontrolujete, zda je MCP server uveden v dashboardu Windsurf.

Příklad zabezpečení API klíčů:

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "npx",
      "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude

1. Ujistěte se, že máte nastavený Node.js a platformu Claude.
2. Upravte konfigurační soubor MCP v Claudovi.
3. Přidejte Gmail MCP Server:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

4. Uložte konfiguraci a restartujte Claude.
5. Ověřte, že je server v Claudovi aktivní.

Příklad proměnných prostředí:

{
  "env": {
    "GOOGLE_CLIENT_ID": "your-client-id",
    "GOOGLE_CLIENT_SECRET": "your-client-secret"
  }
}

Cursor

1. Nainstalujte Node.js a ověřte, že je Cursor spuštěn.
2. Aktualizujte konfiguraci Cursor, aby obsahovala Gmail MCP Server:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

3. Restartujte Cursor, aby se změny projevily.
4. Ověřte integraci kontrolou dostupných MCP serverů.

Cline

1. Připravte prostředí s Node.js.
2. Přidejte záznam Gmail MCP Serveru do konfigurace Cline:

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

3. Uložte a restartujte Cline.
4. Zkontrolujte, že je Gmail MCP Server rozpoznán v rozhraní.

Poznámka:
Citlivé API klíče nebo přihlašovací údaje vždy ukládejte jako proměnné prostředí, nikoliv přímo do konfiguračních souborů. Pro bezpečné vložení přihlašovacích údajů použijte vlastnost env ve vaší MCP konfiguraci.

Jak používat tento MCP ve flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do vašeho workflow ve FlowHunt začněte přidáním MCP komponenty do svého flow a jejím propojením s AI agentem:

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

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

Po konfiguraci může AI agent tento MCP využívat jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit “gmail-mcp” na skutečný název vašeho MCP serveru a URL na adresu vašeho vlastního MCP serveru.

Přehled

Na základě dostupné dokumentace je Gmail MCP Server dobře vybavený pro automatizaci a integraci workflow s Gmailem, ale chybí explicitní šablony promptů a dokumentace k podpoře sampling/roots. Práce s bezpečností a zpřístupněním nástrojů/zdrojů je silná, proto hodnotím tento MCP na 7,5 z 10 co do úplnosti a připravenosti pro vývojáře.

MCP skóre