[{"_1":2,"_329":-5,"_330":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_272":273},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"BOT","id",8144035,"membership","referenceId","01977afc-0380-74ac-b6b6-379a0c651892","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_82":-5,"_83":40,"_29":84,"_189":190,"_271":144},"availableLocales",[28,40,47,54,61,68,75],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Server für die Gmail-Integration in Claude Desktop mit automatischer Authentifizierungsunterstützung. Dieser Server ermöglicht KI-Assistenten die Verwaltung von Gmail durch natürliche Sprachinteraktionen.","name","Gmail AutoAuth MCP-Server","readme","# Gmail AutoAuth MCP-Server\n\nEin Model Context Protocol (MCP)-Server für die Gmail-Integration in Claude Desktop mit automatischer Authentifizierungsunterstützung. Dieser Server ermöglicht KI-Assistenten die Verwaltung von Gmail durch natürliche Sprachinteraktionen.\n\n![](https://badge.mcpx.dev?type=server) [![Schmiedeabzeichen](https://smithery.ai/badge/@gongrzhe/server-gmail-autoauth-mcp)](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp)\n\n## Merkmale\n\n* Senden Sie E-Mails mit Betreff, Inhalt, Anhängen und Empfängern\n* Unterstützung für HTML-E-Mails und mehrteilige Nachrichten sowohl mit HTML- als auch mit Nur-Text-Versionen\n* Vollständige Unterstützung für internationale Zeichen in Betreffzeilen und E-Mail-Inhalten\n* Lesen Sie E-Mail-Nachrichten anhand der ID mit erweiterter MIME-Strukturverarbeitung\n* Informationen zu E-Mail-Anhängen anzeigen (Dateinamen, Typen, Größen)\n* E-Mails anhand verschiedener Kriterien (Betreff, Absender, Datumsbereich) durchsuchen\n* **Umfassende Etikettenverwaltung mit der Möglichkeit, Etiketten zu erstellen, zu aktualisieren, zu löschen und aufzulisten**\n* Alle verfügbaren Gmail-Labels auflisten (systemdefiniert und benutzerdefiniert)\n* Listen Sie E-Mails im Posteingang, in gesendeten oder benutzerdefinierten Labels auf\n* E-Mails als gelesen/ungelesen markieren\n* E-Mails in andere Labels/Ordner verschieben\n* E-Mails löschen\n* **Stapelverarbeitung zur effizienten Verarbeitung mehrerer E-Mails gleichzeitig**\n* Vollständige Integration mit der Gmail-API\n* Einfacher OAuth2-Authentifizierungsablauf mit automatischem Browserstart\n* Unterstützung für Anmeldeinformationen sowohl für Desktop- als auch für Webanwendungen\n* Globale Speicherung von Anmeldeinformationen für mehr Komfort\n\n## Installation und Authentifizierung\n\n### Installation über Smithery\n\nSo installieren Sie Gmail AutoAuth für Claude Desktop automatisch über [Smithery](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp) :\n\n```bash\nnpx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude\n```\n\n### Manuelle Installation\n\n1. Erstellen Sie ein Google Cloud-Projekt und rufen Sie die Anmeldeinformationen ab:\n\n a. Erstellen Sie ein Google Cloud-Projekt:\n\n * Gehen Sie zur [Google Cloud Console](https://console.cloud.google.com/)\n * Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus\n * Aktivieren Sie die Gmail-API für Ihr Projekt\n\n b. OAuth 2.0-Anmeldeinformationen erstellen:\n\n * Gehen Sie zu „APIs & Dienste“ > „Anmeldeinformationen“\n * Klicken Sie auf „Anmeldeinformationen erstellen“ > „OAuth-Client-ID“.\n * Wählen Sie als Anwendungstyp entweder „Desktop-App“ oder „Webanwendung“\n * Geben Sie ihm einen Namen und klicken Sie auf „Erstellen“.\n * Für Webanwendungen fügen Sie `http://localhost:3000/oauth2callback` zu den autorisierten Umleitungs-URIs hinzu.\n * Laden Sie die JSON-Datei mit den OAuth-Schlüsseln Ihres Clients herunter\n * Benennen Sie die Schlüsseldatei in `gcp-oauth.keys.json` um\n\n2. Authentifizierung ausführen:\n\n Sie können sich auf zwei Arten authentifizieren:\n\n a. Globale Authentifizierung (empfohlen):\n\n ```bash\n # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder\n mkdir -p ~/.gmail-mcp\n mv gcp-oauth.keys.json ~/.gmail-mcp/\n\n # Run authentication from anywhere\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n b. Lokale Authentifizierung:\n\n ```bash\n # Place gcp-oauth.keys.json in your current directory\n # The file will be automatically copied to global config\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n Der Authentifizierungsprozess wird:\n\n * Suchen Sie nach `gcp-oauth.keys.json` im aktuellen Verzeichnis oder `~/.gmail-mcp/`\n * Wenn es im aktuellen Verzeichnis gefunden wird, kopieren Sie es nach `~/.gmail-mcp/`\n * Öffnen Sie Ihren Standardbrowser für die Google-Authentifizierung\n * Anmeldeinformationen speichern als `~/.gmail-mcp/credentials.json`\n\n > **Notiz** :\n >\n > * Nach erfolgreicher Authentifizierung werden die Anmeldeinformationen global in `~/.gmail-mcp/` gespeichert und können von jedem Verzeichnis aus verwendet werden\n > * Die Anmeldeinformationen für Desktop-Apps und Webanwendungen werden unterstützt.\n > * Stellen Sie für die Anmeldeinformationen von Webanwendungen sicher, dass Sie `http://localhost:3000/oauth2callback` zu Ihren autorisierten Umleitungs-URIs hinzufügen.\n\n3. In Claude Desktop konfigurieren:\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n}\n```\n\n### Docker-Unterstützung\n\nWenn Sie Docker bevorzugen:\n\n1. Authentifizierung:\n\n```bash\ndocker run -i --rm \\\n --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \\\n -v mcp-gmail:/gmail-server \\\n -e GMAIL_OAUTH_PATH=/gcp-oauth.keys.json \\\n -e \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\" \\\n -p 3000:3000 \\\n mcp/gmail auth\n```\n\n2. Verwendung:\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-v\",\n \"mcp-gmail:/gmail-server\",\n \"-e\",\n \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\",\n \"mcp/gmail\"\n ]\n }\n }\n}\n```\n\n### Cloud-Server-Authentifizierung\n\nFür Cloud-Serverumgebungen (wie n8n) können Sie während der Authentifizierung eine benutzerdefinierte Rückruf-URL angeben:\n\n```bash\nnpx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n```\n\n#### Einrichtungsanweisungen für die Cloud-Umgebung\n\n1. **Reverse-Proxy konfigurieren:**\n\n * Richten Sie Ihren n8n-Container so ein, dass ein Port für die Authentifizierung verfügbar ist\n * Konfigurieren Sie einen Reverse-Proxy, um den Verkehr von Ihrer Domäne (z. B. `gmail.gongrzhe.com` ) an diesen Port weiterzuleiten\n\n2. **DNS-Konfiguration:**\n\n * Fügen Sie in Ihren DNS-Einstellungen einen A-Eintrag hinzu, um Ihre Domain in die IP-Adresse Ihres Cloud-Servers aufzulösen\n\n3. **Einrichtung der Google Cloud Platform:**\n\n * Fügen Sie in Ihrer Google Cloud Console Ihre benutzerdefinierte Domänen-Callback-URL (z. B. `https://gmail.gongrzhe.com/oauth2callback` ) zur Liste der autorisierten Umleitungs-URIs hinzu\n\n4. **Authentifizierung ausführen:**\n\n ```bash\n npx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n ```\n\n5. **Konfigurieren Sie in Ihrer Anwendung:**\n\n ```json\n {\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n }\n ```\n\nDieser Ansatz ermöglicht ordnungsgemäß funktionierende Authentifizierungsabläufe in Umgebungen, in denen der lokale Host nicht zugänglich ist, wie etwa bei containerisierten Anwendungen oder Cloud-Servern.\n\n## Verfügbare Tools\n\nDer Server bietet die folgenden Tools, die über Claude Desktop verwendet werden können:\n\n### 1. E-Mail senden ( `send_email` )\n\nSendet sofort eine neue E-Mail. Unterstützt Nur-Text, HTML und mehrteilige E-Mails.\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"cc\": [\"cc@example.com\"],\n \"bcc\": [\"bcc@example.com\"],\n \"mimeType\": \"text/plain\"\n}\n\n```\n\nHTML-E-Mail-Beispiel:\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"mimeType\": \"text/html\",\n \"body\": \"

Meeting Reminder

Just a reminder about our meeting tomorrow at 10 AM.

Best regards

\"\n}\n```\n\nBeispiel für eine mehrteilige E-Mail (HTML + einfacher Text):\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"mimeType\": \"multipart/alternative\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"htmlBody\": \"

Meeting Reminder

Just a reminder about our meeting tomorrow at 10 AM.

Best regards

\"\n}\n```\n\n### 2. E-Mail-Entwurf ( `draft_email` )\n\nErstellt einen E-Mail-Entwurf, ohne ihn zu senden.\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Draft Report\",\n \"body\": \"Here's the draft report for your review.\",\n \"cc\": [\"manager@example.com\"]\n}\n```\n\n### 3. E-Mail lesen ( `read_email` )\n\nRuft den Inhalt einer bestimmten E-Mail anhand ihrer ID ab.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 4. E-Mails suchen ( `search_emails` )\n\nSucht nach E-Mails mit der Gmail-Suchsyntax.\n\n```json\n{\n \"query\": \"from:sender@example.com after:2024/01/01 has:attachment\",\n \"maxResults\": 10\n}\n```\n\n### 5. E-Mail ändern ( `modify_email` )\n\nFügt Beschriftungen zu E-Mails hinzu oder entfernt sie (in andere Ordner verschieben, archivieren usw.).\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\",\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"]\n}\n```\n\n### 6. E-Mail löschen ( `delete_email` )\n\nLöscht eine E-Mail dauerhaft.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 7. E-Mail-Labels auflisten ( `list_email_labels` )\n\nRuft alle verfügbaren Gmail-Labels ab.\n\n```json\n{}\n```\n\n### 8. Label erstellen ( `create_label` )\n\nErstellt ein neues Gmail-Label.\n\n```json\n{\n \"name\": \"Important Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 9. Label aktualisieren ( `update_label` )\n\nAktualisiert ein vorhandenes Gmail-Label.\n\n```json\n{\n \"id\": \"Label_1234567890\",\n \"name\": \"Urgent Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 10. Label löschen ( `delete_label` )\n\nLöscht ein Gmail-Label.\n\n```json\n{\n \"id\": \"Label_1234567890\"\n}\n```\n\n### 11. Label abrufen oder erstellen ( `get_or_create_label` )\n\nRuft ein vorhandenes Label nach Namen ab oder erstellt es, wenn es nicht vorhanden ist.\n\n```json\n{\n \"name\": \"Project XYZ\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 12. E-Mails stapelweise ändern ( `batch_modify_emails` )\n\nÄndert Beschriftungen für mehrere E-Mails in effizienten Stapeln.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"],\n \"batchSize\": 50\n}\n```\n\n### 13. E-Mails stapelweise löschen ( `batch_delete_emails` )\n\nLöscht mehrere E-Mails dauerhaft in effizienten Stapeln.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"batchSize\": 50\n}\n```\n\n## Erweiterte Suchsyntax\n\nDas Tool `search_emails` unterstützt die leistungsstarken Suchoperatoren von Gmail:\n\n| Operator | Beispiel | Beschreibung |\n| ---------------- | ------------------------- | ----------------------------------------------- |\n| `from:` | `from:john@example.com` | E-Mails von einem bestimmten Absender |\n| `to:` | `to:mary@example.com` | An einen bestimmten Empfänger gesendete E-Mails |\n| `subject:` | `subject:\"meeting notes\"` | E-Mails mit spezifischem Text im Betreff |\n| `has:attachment` | `has:attachment` | E-Mails mit Anhängen |\n| `after:` | `after:2024/01/01` | Nach einem bestimmten Datum empfangene E-Mails |\n| `before:` | `before:2024/02/01` | Vor einem Datum empfangene E-Mails |\n| `is:` | `is:unread` | E-Mails mit einem bestimmten Status |\n| `label:` | `label:work` | E-Mails mit einem bestimmten Label |\n\nSie können mehrere Operatoren kombinieren: `from:john@example.com after:2024/01/01 has:attachment`\n\n## Erweiterte Funktionen\n\n### Extraktion von E-Mail-Inhalten\n\nDer Server extrahiert E-Mail-Inhalte auf intelligente Weise aus komplexen MIME-Strukturen:\n\n* Priorisiert Klartextinhalte, sofern verfügbar\n* Fällt auf HTML-Inhalte zurück, wenn kein einfacher Text verfügbar ist\n* Verarbeitet mehrteilige MIME-Nachrichten mit verschachtelten Teilen\n* Verarbeitet Informationen zu Anhängen (Dateiname, Typ, Größe)\n* Behält die ursprünglichen E-Mail-Header bei (Von, An, Betreff, Datum)\n\n### Internationaler Charakter-Support\n\nDer Server unterstützt vollständig Nicht-ASCII-Zeichen in E-Mail-Betreffzeilen und -Inhalten, einschließlich:\n\n* Türkische, chinesische, japanische, koreanische und andere nicht-lateinische Alphabete\n* Sonderzeichen und Symbole\n* Die richtige Kodierung gewährleistet die korrekte Anzeige in E-Mail-Clients\n\n### Umfassendes Etikettenmanagement\n\nDer Server bietet einen vollständigen Satz von Tools zum Verwalten von Gmail-Labels:\n\n* **Etiketten erstellen** : Erstellen Sie neue Etiketten mit anpassbaren Sichtbarkeitseinstellungen\n* **Beschriftungen aktualisieren** : Benennen Sie Beschriftungen um oder ändern Sie ihre Sichtbarkeitseinstellungen\n* **Beschriftungen löschen** : Vom Benutzer erstellte Beschriftungen entfernen (Systembeschriftungen sind geschützt)\n* **Suchen oder Erstellen** : Holen Sie sich ein Etikett nach Namen oder erstellen Sie es automatisch, wenn es nicht gefunden wird\n* **Alle Labels auflisten** : Alle System- und Benutzerlabels mit detaillierten Informationen anzeigen\n* **Optionen für die Beschriftungssichtbarkeit** : Steuern Sie, wie Beschriftungen in Nachrichten- und Beschriftungslisten angezeigt werden\n\nZu den Einstellungen für die Beschriftungssichtbarkeit gehören:\n\n* `messageListVisibility` : Steuert, ob das Label in der Nachrichtenliste angezeigt wird ( `show` oder `hide` ).\n* `labelListVisibility` : Steuert, wie das Label in der Labelliste angezeigt wird ( `labelShow` , `labelShowIfUnread` oder `labelHide` )\n\nDiese Funktionen zur Etikettenverwaltung ermöglichen eine anspruchsvolle Organisation von E-Mails direkt über Claude, ohne dass Sie zur Gmail-Oberfläche wechseln müssen.\n\n### Batch-Operationen\n\nDer Server verfügt über effiziente Stapelverarbeitungsfunktionen:\n\n* Verarbeiten Sie bis zu 50 E-Mails gleichzeitig (konfigurierbare Stapelgröße)\n* Automatische Aufteilung großer E-Mail-Gruppen zur Vermeidung von API-Beschränkungen\n* Detaillierte Erfolgs-/Fehlerberichte für jeden Vorgang\n* Sanfte Fehlerbehandlung mit individuellen Wiederholungsversuchen\n* Perfekt für die Massenverwaltung und Organisation von Posteingängen\n\n## Sicherheitshinweise\n\n* OAuth-Anmeldeinformationen werden sicher in Ihrer lokalen Umgebung gespeichert ( `~/.gmail-mcp/` )\n* Der Server verwendet den Offline-Zugriff, um eine dauerhafte Authentifizierung aufrechtzuerhalten\n* Geben Sie Ihre Anmeldeinformationen niemals an die Versionskontrolle weiter und übergeben Sie sie nicht\n* Überprüfen und widerrufen Sie regelmäßig ungenutzte Zugriffe in Ihren Google-Kontoeinstellungen.\n* Anmeldeinformationen werden global gespeichert, sind aber nur für den aktuellen Benutzer zugänglich\n\n## Fehlerbehebung\n\n1. **OAuth-Schlüssel nicht gefunden**\n\n * Stellen Sie sicher, dass sich `gcp-oauth.keys.json` entweder in Ihrem aktuellen Verzeichnis oder in `~/.gmail-mcp/` befindet.\n * Überprüfen Sie die Dateiberechtigungen\n\n2. **Ungültiges Anmeldeinformationsformat**\n\n * Stellen Sie sicher, dass Ihre OAuth-Schlüsseldatei entweder `web` oder `installed` Anmeldeinformationen enthält\n * Überprüfen Sie bei Webanwendungen, ob die Umleitungs-URI richtig konfiguriert ist\n\n3. **Port wird bereits verwendet**\n\n * Wenn Port 3000 bereits verwendet wird, geben Sie ihn bitte frei, bevor Sie die Authentifizierung ausführen\n * Sie können den Prozess über diesen Port finden und stoppen\n\n4. **Fehler bei Batchvorgängen**\n\n * Wenn Batch-Operationen fehlschlagen, werden einzelne Elemente automatisch erneut versucht\n * Überprüfen Sie die detaillierten Fehlermeldungen auf bestimmte Fehler\n * Erwägen Sie eine Reduzierung der Batchgröße, wenn Sie auf eine Ratenbegrenzung stoßen.\n\n## Beitragen\n\nBeiträge sind willkommen! Senden Sie gerne einen Pull Request.\n\n## Ausführen von Evaluierungen\n\nDas Evals-Paket lädt einen MCP-Client, der anschließend die Datei index.ts ausführt, sodass zwischen den Tests kein Neuaufbau erforderlich ist. Sie können Umgebungsvariablen laden, indem Sie dem Befehl npx voranstellen. Die vollständige Dokumentation finden Sie [hier](https://www.mcpevals.io/docs) .\n\n```bash\nOPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts\n```\n\n## Lizenz\n\nMIT\n\n## Unterstützung\n\nWenn Sie auf Probleme stoßen oder Fragen haben, melden Sie bitte ein Problem im GitHub-Repository.","German","tag","de-DE",{"_29":41,"_33":45,"_38":46},{"_31":42,"_33":43,"_35":44},"Server for Gmail integration in Claude Desktop with auto authentication support. This server enables AI assistants to manage Gmail through natural language interactions.","Gmail AutoAuth MCP Server","# Gmail AutoAuth MCP Server\n\nA Model Context Protocol (MCP) server for Gmail integration in Claude Desktop with auto authentication support. This server enables AI assistants to manage Gmail through natural language interactions.\n\n![](https://badge.mcpx.dev?type=server 'MCP Server')\n[![smithery badge](https://smithery.ai/badge/@gongrzhe/server-gmail-autoauth-mcp)](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp)\n\n\n## Features\n\n- Send emails with subject, content, attachments, and recipients\n- Support for HTML emails and multipart messages with both HTML and plain text versions\n- Full support for international characters in subject lines and email content\n- Read email messages by ID with advanced MIME structure handling\n- View email attachments information (filenames, types, sizes)\n- Search emails with various criteria (subject, sender, date range)\n- **Comprehensive label management with ability to create, update, delete and list labels**\n- List all available Gmail labels (system and user-defined)\n- List emails in inbox, sent, or custom labels\n- Mark emails as read/unread\n- Move emails to different labels/folders\n- Delete emails\n- **Batch operations for efficiently processing multiple emails at once**\n- Full integration with Gmail API\n- Simple OAuth2 authentication flow with auto browser launch\n- Support for both Desktop and Web application credentials\n- Global credential storage for convenience\n\n## Installation & Authentication\n\n### Installing via Smithery\n\nTo install Gmail AutoAuth for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp):\n\n```bash\nnpx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude\n```\n\n### Installing Manually\n1. Create a Google Cloud Project and obtain credentials:\n\n a. Create a Google Cloud Project:\n - Go to [Google Cloud Console](https://console.cloud.google.com/)\n - Create a new project or select an existing one\n - Enable the Gmail API for your project\n\n b. Create OAuth 2.0 Credentials:\n - Go to \"APIs & Services\" > \"Credentials\"\n - Click \"Create Credentials\" > \"OAuth client ID\"\n - Choose either \"Desktop app\" or \"Web application\" as application type\n - Give it a name and click \"Create\"\n - For Web application, add `http://localhost:3000/oauth2callback` to the authorized redirect URIs\n - Download the JSON file of your client's OAuth keys\n - Rename the key file to `gcp-oauth.keys.json`\n\n2. Run Authentication:\n\n You can authenticate in two ways:\n\n a. Global Authentication (Recommended):\n ```bash\n # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder\n mkdir -p ~/.gmail-mcp\n mv gcp-oauth.keys.json ~/.gmail-mcp/\n\n # Run authentication from anywhere\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n b. Local Authentication:\n ```bash\n # Place gcp-oauth.keys.json in your current directory\n # The file will be automatically copied to global config\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n The authentication process will:\n - Look for `gcp-oauth.keys.json` in the current directory or `~/.gmail-mcp/`\n - If found in current directory, copy it to `~/.gmail-mcp/`\n - Open your default browser for Google authentication\n - Save credentials as `~/.gmail-mcp/credentials.json`\n\n > **Note**: \n > - After successful authentication, credentials are stored globally in `~/.gmail-mcp/` and can be used from any directory\n > - Both Desktop app and Web application credentials are supported\n > - For Web application credentials, make sure to add `http://localhost:3000/oauth2callback` to your authorized redirect URIs\n\n3. Configure in Claude Desktop:\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n}\n```\n\n### Docker Support\n\nIf you prefer using Docker:\n\n1. Authentication:\n```bash\ndocker run -i --rm \\\n --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \\\n -v mcp-gmail:/gmail-server \\\n -e GMAIL_OAUTH_PATH=/gcp-oauth.keys.json \\\n -e \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\" \\\n -p 3000:3000 \\\n mcp/gmail auth\n```\n\n2. Usage:\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-v\",\n \"mcp-gmail:/gmail-server\",\n \"-e\",\n \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\",\n \"mcp/gmail\"\n ]\n }\n }\n}\n```\n\n### Cloud Server Authentication\n\nFor cloud server environments (like n8n), you can specify a custom callback URL during authentication:\n\n```bash\nnpx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n```\n\n#### Setup Instructions for Cloud Environment\n\n1. **Configure Reverse Proxy:**\n - Set up your n8n container to expose a port for authentication\n - Configure a reverse proxy to forward traffic from your domain (e.g., `gmail.gongrzhe.com`) to this port\n\n2. **DNS Configuration:**\n - Add an A record in your DNS settings to resolve your domain to your cloud server's IP address\n\n3. **Google Cloud Platform Setup:**\n - In your Google Cloud Console, add your custom domain callback URL (e.g., `https://gmail.gongrzhe.com/oauth2callback`) to the authorized redirect URIs list\n\n4. **Run Authentication:**\n ```bash\n npx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n ```\n\n5. **Configure in your application:**\n ```json\n {\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n }\n ```\n\nThis approach allows authentication flows to work properly in environments where localhost isn't accessible, such as containerized applications or cloud servers.\n\n## Available Tools\n\nThe server provides the following tools that can be used through Claude Desktop:\n\n### 1. Send Email (`send_email`)\n\nSends a new email immediately. Supports plain text, HTML, or multipart emails.\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"cc\": [\"cc@example.com\"],\n \"bcc\": [\"bcc@example.com\"],\n \"mimeType\": \"text/plain\"\n}\n\n```\nHTML Email Example:\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"mimeType\": \"text/html\",\n \"body\": \"

Meeting Reminder

Just a reminder about our meeting tomorrow at 10 AM.

Best regards

\"\n}\n```\n\nMultipart Email Example (HTML + Plain Text):\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"mimeType\": \"multipart/alternative\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"htmlBody\": \"

Meeting Reminder

Just a reminder about our meeting tomorrow at 10 AM.

Best regards

\"\n}\n```\n\n### 2. Draft Email (`draft_email`)\nCreates a draft email without sending it.\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Draft Report\",\n \"body\": \"Here's the draft report for your review.\",\n \"cc\": [\"manager@example.com\"]\n}\n```\n\n### 3. Read Email (`read_email`)\nRetrieves the content of a specific email by its ID.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 4. Search Emails (`search_emails`)\nSearches for emails using Gmail search syntax.\n\n```json\n{\n \"query\": \"from:sender@example.com after:2024/01/01 has:attachment\",\n \"maxResults\": 10\n}\n```\n\n### 5. Modify Email (`modify_email`)\nAdds or removes labels from emails (move to different folders, archive, etc.).\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\",\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"]\n}\n```\n\n### 6. Delete Email (`delete_email`)\nPermanently deletes an email.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 7. List Email Labels (`list_email_labels`)\nRetrieves all available Gmail labels.\n\n```json\n{}\n```\n\n### 8. Create Label (`create_label`)\nCreates a new Gmail label.\n\n```json\n{\n \"name\": \"Important Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 9. Update Label (`update_label`)\nUpdates an existing Gmail label.\n\n```json\n{\n \"id\": \"Label_1234567890\",\n \"name\": \"Urgent Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 10. Delete Label (`delete_label`)\nDeletes a Gmail label.\n\n```json\n{\n \"id\": \"Label_1234567890\"\n}\n```\n\n### 11. Get or Create Label (`get_or_create_label`)\nGets an existing label by name or creates it if it doesn't exist.\n\n```json\n{\n \"name\": \"Project XYZ\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 12. Batch Modify Emails (`batch_modify_emails`)\nModifies labels for multiple emails in efficient batches.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"],\n \"batchSize\": 50\n}\n```\n\n### 13. Batch Delete Emails (`batch_delete_emails`)\nPermanently deletes multiple emails in efficient batches.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"batchSize\": 50\n}\n```\n\n## Advanced Search Syntax\n\nThe `search_emails` tool supports Gmail's powerful search operators:\n\n| Operator | Example | Description |\n|----------|---------|-------------|\n| `from:` | `from:john@example.com` | Emails from a specific sender |\n| `to:` | `to:mary@example.com` | Emails sent to a specific recipient |\n| `subject:` | `subject:\"meeting notes\"` | Emails with specific text in the subject |\n| `has:attachment` | `has:attachment` | Emails with attachments |\n| `after:` | `after:2024/01/01` | Emails received after a date |\n| `before:` | `before:2024/02/01` | Emails received before a date |\n| `is:` | `is:unread` | Emails with a specific state |\n| `label:` | `label:work` | Emails with a specific label |\n\nYou can combine multiple operators: `from:john@example.com after:2024/01/01 has:attachment`\n\n## Advanced Features\n\n### Email Content Extraction\n\nThe server intelligently extracts email content from complex MIME structures:\n\n- Prioritizes plain text content when available\n- Falls back to HTML content if plain text is not available\n- Handles multi-part MIME messages with nested parts\n- Processes attachments information (filename, type, size)\n- Preserves original email headers (From, To, Subject, Date)\n\n### International Character Support\n\nThe server fully supports non-ASCII characters in email subjects and content, including:\n- Turkish, Chinese, Japanese, Korean, and other non-Latin alphabets\n- Special characters and symbols\n- Proper encoding ensures correct display in email clients\n\n### Comprehensive Label Management\n\nThe server provides a complete set of tools for managing Gmail labels:\n\n- **Create Labels**: Create new labels with customizable visibility settings\n- **Update Labels**: Rename labels or change their visibility settings\n- **Delete Labels**: Remove user-created labels (system labels are protected)\n- **Find or Create**: Get a label by name or automatically create it if not found\n- **List All Labels**: View all system and user labels with detailed information\n- **Label Visibility Options**: Control how labels appear in message and label lists\n\nLabel visibility settings include:\n- `messageListVisibility`: Controls whether the label appears in the message list (`show` or `hide`)\n- `labelListVisibility`: Controls how the label appears in the label list (`labelShow`, `labelShowIfUnread`, or `labelHide`)\n\nThese label management features enable sophisticated organization of emails directly through Claude, without needing to switch to the Gmail interface.\n\n### Batch Operations\n\nThe server includes efficient batch processing capabilities:\n\n- Process up to 50 emails at once (configurable batch size)\n- Automatic chunking of large email sets to avoid API limits\n- Detailed success/failure reporting for each operation\n- Graceful error handling with individual retries\n- Perfect for bulk inbox management and organization tasks\n\n## Security Notes\n\n- OAuth credentials are stored securely in your local environment (`~/.gmail-mcp/`)\n- The server uses offline access to maintain persistent authentication\n- Never share or commit your credentials to version control\n- Regularly review and revoke unused access in your Google Account settings\n- Credentials are stored globally but are only accessible by the current user\n\n## Troubleshooting\n\n1. **OAuth Keys Not Found**\n - Make sure `gcp-oauth.keys.json` is in either your current directory or `~/.gmail-mcp/`\n - Check file permissions\n\n2. **Invalid Credentials Format**\n - Ensure your OAuth keys file contains either `web` or `installed` credentials\n - For web applications, verify the redirect URI is correctly configured\n\n3. **Port Already in Use**\n - If port 3000 is already in use, please free it up before running authentication\n - You can find and stop the process using that port\n\n4. **Batch Operation Failures**\n - If batch operations fail, they automatically retry individual items\n - Check the detailed error messages for specific failures\n - Consider reducing the batch size if you encounter rate limiting\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n\n## Running evals\n\nThe evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found [here](https://www.mcpevals.io/docs).\n\n```bash\nOPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts\n```\n\n## License\n\nMIT\n\n## Support\n\nIf you encounter any issues or have questions, please file an issue on the GitHub repository.","English","en-US",{"_29":48,"_33":52,"_38":53},{"_31":49,"_33":50,"_35":51},"Servidor para la integración de Gmail en Claude Desktop con autenticación automática. Este servidor permite que los asistentes de IA gestionen Gmail mediante interacciones con lenguaje natural.","Servidor MCP de autenticación automática de Gmail","# Servidor MCP de autenticación automática de Gmail\n\nUn servidor de Protocolo de Contexto de Modelo (MCP) para la integración de Gmail en Claude Desktop con compatibilidad con autenticación automática. Este servidor permite a los asistentes de IA gestionar Gmail mediante interacciones de lenguaje natural.\n\n![](https://badge.mcpx.dev?type=server) [![insignia de herrería](https://smithery.ai/badge/@gongrzhe/server-gmail-autoauth-mcp)](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp)\n\n## Características\n\n* Enviar correos electrónicos con asunto, contenido, archivos adjuntos y destinatarios\n* Soporte completo para caracteres internacionales en líneas de asunto y contenido de correo electrónico\n* Leer mensajes de correo electrónico por ID con manejo avanzado de estructura MIME\n* Ver información de archivos adjuntos de correo electrónico (nombres de archivo, tipos, tamaños)\n* Buscar correos electrónicos con varios criterios (asunto, remitente, rango de fechas)\n* **Gestión integral de etiquetas con capacidad para crear, actualizar, eliminar y enumerar etiquetas**\n* Enumere todas las etiquetas de Gmail disponibles (del sistema y definidas por el usuario)\n* Lista de correos electrónicos en la bandeja de entrada, enviados o etiquetas personalizadas\n* Marcar correos electrónicos como leídos/no leídos\n* Mover correos electrónicos a diferentes etiquetas/carpetas\n* Eliminar correos electrónicos\n* **Operaciones por lotes para procesar eficientemente varios correos electrónicos a la vez**\n* Integración completa con la API de Gmail\n* Flujo de autenticación OAuth2 simple con inicio automático del navegador\n* Compatibilidad con credenciales de aplicaciones web y de escritorio\n* Almacenamiento global de credenciales para mayor comodidad\n\n## Instalación y autenticación\n\n### Instalación mediante herrería\n\nPara instalar Gmail AutoAuth para Claude Desktop automáticamente a través de [Smithery](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp) :\n\n```bash\nnpx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude\n```\n\n### Instalación manual\n\n1. Crea un proyecto de Google Cloud y obtén las credenciales:\n\n a. Crear un proyecto de Google Cloud:\n\n * Ir a [la consola de Google Cloud](https://console.cloud.google.com/)\n * Crea un nuevo proyecto o selecciona uno existente\n * Habilite la API de Gmail para su proyecto\n\n b. Crear credenciales OAuth 2.0:\n\n * Vaya a \"API y servicios\" > \"Credenciales\".\n * Haga clic en \"Crear credenciales\" > \"ID de cliente OAuth\".\n * Elija \"Aplicación de escritorio\" o \"Aplicación web\" como tipo de aplicación\n * Dale un nombre y haz clic en \"Crear\"\n * Para la aplicación web, agregue `http://localhost:3000/oauth2callback` a las URI de redireccionamiento autorizadas\n * Descargue el archivo JSON de las claves OAuth de su cliente\n * Cambie el nombre del archivo de clave a `gcp-oauth.keys.json`\n\n2. Ejecutar autenticación:\n\n Puedes autenticarte de dos maneras:\n\n a. Autenticación global (recomendada):\n\n ```bash\n # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder\n mkdir -p ~/.gmail-mcp\n mv gcp-oauth.keys.json ~/.gmail-mcp/\n\n # Run authentication from anywhere\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n b. Autenticación local:\n\n ```bash\n # Place gcp-oauth.keys.json in your current directory\n # The file will be automatically copied to global config\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n El proceso de autenticación:\n\n * Busque `gcp-oauth.keys.json` en el directorio actual o `~/.gmail-mcp/`\n * Si se encuentra en el directorio actual, cópielo a `~/.gmail-mcp/`\n * Abra su navegador predeterminado para la autenticación de Google\n * Guardar las credenciales como `~/.gmail-mcp/credentials.json`\n\n > **Nota** :\n >\n > * Después de una autenticación exitosa, las credenciales se almacenan globalmente en `~/.gmail-mcp/` y se pueden usar desde cualquier directorio.\n > * Se admiten credenciales tanto de aplicaciones de escritorio como de aplicaciones web\n > * Para las credenciales de la aplicación web, asegúrese de agregar `http://localhost:3000/oauth2callback` a sus URI de redireccionamiento autorizados\n\n3. Configurar en Claude Desktop:\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n}\n```\n\n### Soporte de Docker\n\nSi prefieres usar Docker:\n\n1. Autenticación:\n\n```bash\ndocker run -i --rm \\\n --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \\\n -v mcp-gmail:/gmail-server \\\n -e GMAIL_OAUTH_PATH=/gcp-oauth.keys.json \\\n -e \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\" \\\n -p 3000:3000 \\\n mcp/gmail auth\n```\n\n2. Uso:\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-v\",\n \"mcp-gmail:/gmail-server\",\n \"-e\",\n \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\",\n \"mcp/gmail\"\n ]\n }\n }\n}\n```\n\n### Autenticación del servidor en la nube\n\nPara entornos de servidores en la nube (como n8n), puede especificar una URL de devolución de llamada personalizada durante la autenticación:\n\n```bash\nnpx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n```\n\n#### Instrucciones de configuración para el entorno de nube\n\n1. **Configurar proxy inverso:**\n\n * Configure su contenedor n8n para exponer un puerto para la autenticación\n * Configure un proxy inverso para reenviar el tráfico desde su dominio (por ejemplo, `gmail.gongrzhe.com` ) a este puerto\n\n2. **Configuración de DNS:**\n\n * Agregue un registro A en su configuración de DNS para resolver su dominio a la dirección IP de su servidor en la nube\n\n3. **Configuración de Google Cloud Platform:**\n\n * En Google Cloud Console, agregue su URL de devolución de llamada de dominio personalizado (por ejemplo, `https://gmail.gongrzhe.com/oauth2callback` ) a la lista de URI de redireccionamiento autorizados.\n\n4. **Ejecutar autenticación:**\n\n ```bash\n npx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n ```\n\n5. **Configura en tu aplicación:**\n\n ```json\n {\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n }\n ```\n\nEste enfoque permite que los flujos de autenticación funcionen correctamente en entornos donde no se puede acceder al host local, como aplicaciones en contenedores o servidores en la nube.\n\n## Herramientas disponibles\n\nEl servidor proporciona las siguientes herramientas que se pueden utilizar a través de Claude Desktop:\n\n### 1. Enviar correo electrónico ( `send_email` )\n\nEnvía un nuevo correo electrónico inmediatamente.\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"cc\": [\"cc@example.com\"],\n \"bcc\": [\"bcc@example.com\"]\n}\n```\n\n### 2. Borrador de correo electrónico ( `draft_email` )\n\nCrea un borrador de correo electrónico sin enviarlo.\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Draft Report\",\n \"body\": \"Here's the draft report for your review.\",\n \"cc\": [\"manager@example.com\"]\n}\n```\n\n### 3. Leer correo electrónico ( `read_email` )\n\nRecupera el contenido de un correo electrónico específico por su ID.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 4. Buscar correos electrónicos ( `search_emails` )\n\nBusca correos electrónicos utilizando la sintaxis de búsqueda de Gmail.\n\n```json\n{\n \"query\": \"from:sender@example.com after:2024/01/01 has:attachment\",\n \"maxResults\": 10\n}\n```\n\n### 5. Modificar el correo electrónico ( `modify_email` )\n\nAgrega o elimina etiquetas de los correos electrónicos (mover a diferentes carpetas, archivar, etc.).\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\",\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"]\n}\n```\n\n### 6. Eliminar correo electrónico ( `delete_email` )\n\nElimina permanentemente un correo electrónico.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 7. Lista de etiquetas de correo electrónico ( `list_email_labels` )\n\nRecupera todas las etiquetas de Gmail disponibles.\n\n```json\n{}\n```\n\n### 8. Crear etiqueta ( `create_label` )\n\nCrea una nueva etiqueta de Gmail.\n\n```json\n{\n \"name\": \"Important Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 9. Actualizar etiqueta ( `update_label` )\n\nActualiza una etiqueta de Gmail existente.\n\n```json\n{\n \"id\": \"Label_1234567890\",\n \"name\": \"Urgent Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 10. Eliminar etiqueta ( `delete_label` )\n\nElimina una etiqueta de Gmail.\n\n```json\n{\n \"id\": \"Label_1234567890\"\n}\n```\n\n### 11. Obtener o crear etiqueta ( `get_or_create_label` )\n\nObtiene una etiqueta existente por nombre o la crea si no existe.\n\n```json\n{\n \"name\": \"Project XYZ\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 12. Modificar correos electrónicos por lotes ( `batch_modify_emails` )\n\nModifica las etiquetas de múltiples correos electrónicos en lotes eficientes.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"],\n \"batchSize\": 50\n}\n```\n\n### 13. Eliminar correos electrónicos por lotes ( `batch_delete_emails` )\n\nElimina permanentemente varios correos electrónicos en lotes eficientes.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"batchSize\": 50\n}\n```\n\n## Sintaxis de búsqueda avanzada\n\nLa herramienta `search_emails` admite los potentes operadores de búsqueda de Gmail:\n\n| Operador | Ejemplo | Descripción |\n| ---------------- | ------------------------- | ---------------------------------------------------------- |\n| `from:` | `from:john@example.com` | Correos electrónicos de un remitente específico |\n| `to:` | `to:mary@example.com` | Correos electrónicos enviados a un destinatario específico |\n| `subject:` | `subject:\"meeting notes\"` | Correos electrónicos con texto específico en el asunto |\n| `has:attachment` | `has:attachment` | Correos electrónicos con archivos adjuntos |\n| `after:` | `after:2024/01/01` | Correos electrónicos recibidos después de una fecha |\n| `before:` | `before:2024/02/01` | Correos electrónicos recibidos antes de una fecha |\n| `is:` | `is:unread` | Correos electrónicos con un estado específico |\n| `label:` | `label:work` | Correos electrónicos con una etiqueta específica |\n\nPuedes combinar varios operadores: `from:john@example.com after:2024/01/01 has:attachment`\n\n## Funciones avanzadas\n\n### Extracción de contenido de correo electrónico\n\nEl servidor extrae de forma inteligente el contenido del correo electrónico de estructuras MIME complejas:\n\n* Prioriza el contenido de texto simple cuando está disponible\n* Vuelve al contenido HTML si no hay texto sin formato disponible\n* Maneja mensajes MIME de varias partes con partes anidadas\n* Procesa información de archivos adjuntos (nombre de archivo, tipo, tamaño)\n* Conserva los encabezados de correo electrónico originales (De, Para, Asunto, Fecha)\n\n### Soporte de personajes internacionales\n\nEl servidor admite totalmente caracteres no ASCII en los asuntos y el contenido de los correos electrónicos, incluidos:\n\n* Turco, chino, japonés, coreano y otros alfabetos no latinos\n* Caracteres y símbolos especiales\n* La codificación adecuada garantiza una visualización correcta en los clientes de correo electrónico.\n\n### Gestión integral de etiquetas\n\nEl servidor proporciona un conjunto completo de herramientas para administrar las etiquetas de Gmail:\n\n* **Crear etiquetas** : crea nuevas etiquetas con configuraciones de visibilidad personalizables\n* **Actualizar etiquetas** : cambie el nombre de las etiquetas o cambie su configuración de visibilidad\n* **Eliminar etiquetas** : elimina las etiquetas creadas por el usuario (las etiquetas del sistema están protegidas)\n* **Buscar o crear** : obtener una etiqueta por nombre o crearla automáticamente si no se encuentra\n* **Listar todas las etiquetas** : Ver todas las etiquetas del sistema y del usuario con información detallada\n* **Opciones de visibilidad de etiquetas** : controla cómo aparecen las etiquetas en los mensajes y las listas de etiquetas\n\nLas configuraciones de visibilidad de la etiqueta incluyen:\n\n* `messageListVisibility` : controla si la etiqueta aparece en la lista de mensajes ( `show` u `hide` )\n* `labelListVisibility` : controla cómo aparece la etiqueta en la lista de etiquetas ( `labelShow` , `labelShowIfUnread` o `labelHide` )\n\nEstas funciones de administración de etiquetas permiten una organización sofisticada de correos electrónicos directamente a través de Claude, sin necesidad de cambiar a la interfaz de Gmail.\n\n### Operaciones por lotes\n\nEl servidor incluye capacidades eficientes de procesamiento por lotes:\n\n* Procesar hasta 50 correos electrónicos a la vez (tamaño de lote configurable)\n* Fragmentación automática de grandes conjuntos de correos electrónicos para evitar los límites de la API\n* Informes detallados de éxito/fracaso de cada operación\n* Manejo elegante de errores con reintentos individuales\n* Perfecto para la gestión masiva de bandejas de entrada y tareas de organización.\n\n## Notas de seguridad\n\n* Las credenciales de OAuth se almacenan de forma segura en su entorno local ( `~/.gmail-mcp/` )\n* El servidor utiliza acceso sin conexión para mantener una autenticación persistente\n* Nunca comparta ni comprometa sus credenciales con el control de versiones\n* Revise y revoque periódicamente el acceso no utilizado en la configuración de su cuenta de Google\n* Las credenciales se almacenan globalmente, pero solo el usuario actual puede acceder a ellas.\n\n## Solución de problemas\n\n1. **Claves OAuth no encontradas**\n\n * Asegúrese de que `gcp-oauth.keys.json` esté en su directorio actual o en `~/.gmail-mcp/`\n * Comprobar permisos de archivos\n\n2. **Formato de credenciales no válidas**\n\n * Asegúrese de que su archivo de claves OAuth contenga credenciales `web` o `installed`\n * Para aplicaciones web, verifique que la URI de redireccionamiento esté configurada correctamente\n\n3. **Puerto ya en uso**\n\n * Si el puerto 3000 ya está en uso, libérelo antes de ejecutar la autenticación\n * Puedes encontrar y detener el proceso usando ese puerto\n\n4. **Fallas en las operaciones por lotes**\n\n * Si las operaciones por lotes fallan, se vuelven a intentar automáticamente los elementos individuales.\n * Consulte los mensajes de error detallados para detectar fallas específicas\n * Considere reducir el tamaño del lote si encuentra una limitación de velocidad\n\n## Contribuyendo\n\n¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.\n\n## Ejecución de evaluaciones\n\nEl paquete evals carga un cliente mcp que ejecuta el archivo index.ts, por lo que no es necesario reconstruir entre pruebas. Puede cargar variables de entorno prefijando el comando npx. Puede encontrar la documentación completa [aquí](https://www.mcpevals.io/docs) .\n\n```bash\nOPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts\n```\n\n## Licencia\n\nInstituto Tecnológico de Massachusetts (MIT)\n\n## Apoyo\n\nSi encuentra algún problema o tiene preguntas, envíe un problema en el repositorio de GitHub.","Spanish","es-ES",{"_29":55,"_33":59,"_38":60},{"_31":56,"_33":57,"_35":58},"Claude Desktop の Gmail 統合用サーバー。自動認証をサポートします。このサーバーにより、AI アシスタントが自然言語によるインタラクションを通じて Gmail を管理できるようになります。","Gmail 自動認証 MCP サーバー","# Gmail 自動認証 MCP サーバー\n\nClaude Desktop に Gmail を統合するための、自動認証をサポートするモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、AI アシスタントが自然言語によるインタラクションを通じて Gmail を管理できるようになります。\n\n![](https://badge.mcpx.dev?type=server) [![鍛冶屋のバッジ](https://smithery.ai/badge/@gongrzhe/server-gmail-autoauth-mcp)](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp)\n\n## 特徴\n\n* 件名、内容、添付ファイル、受信者を指定してメールを送信する\n* 件名とメール本文で国際文字を完全サポート\n* 高度な MIME 構造処理を使用して ID で電子メールメッセージを読み取る\n* メールの添付ファイル情報（ファイル名、種類、サイズ）を表示する\n* さまざまな条件（件名、送信者、日付範囲）でメールを検索します\n* **ラベルの作成、更新、削除、一覧表示が可能な包括的なラベル管理**\n* 利用可能なすべての Gmail ラベル（システムおよびユーザー定義）を一覧表示します\n* 受信トレイ、送信済み、またはカスタムラベル内のメールを一覧表示する\n* メールを既読/未読としてマークする\n* メールを別のラベル/フォルダに移動する\n* メールを削除する\n* **複数のメールを一度に効率的に処理するためのバッチ操作**\n* Gmail APIとの完全な統合\n* 自動ブラウザ起動によるシンプルなOAuth2認証フロー\n* デスクトップとWebアプリケーションの両方の資格情報のサポート\n* 利便性のためのグローバル認証情報ストレージ\n\n## インストールと認証\n\n### Smithery経由でインストール\n\n[Smithery](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp)経由で Claude Desktop 用の Gmail AutoAuth を自動的にインストールするには:\n\n```bash\nnpx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude\n```\n\n### 手動でインストールする\n\n1. Google Cloud プロジェクトを作成し、認証情報を取得します。\n\n a. Google Cloud プロジェクトを作成します。\n\n * [Google Cloud Console](https://console.cloud.google.com/)に移動\n * 新しいプロジェクトを作成するか、既存のプロジェクトを選択してください\n * プロジェクトで Gmail API を有効にする\n\n b. OAuth 2.0 認証情報を作成する:\n\n * 「APIとサービス」>「認証情報」に移動します\n * 「認証情報を作成」>「OAuthクライアントID」をクリックします\n * アプリケーションの種類として「デスクトップアプリ」または「Webアプリケーション」を選択します\n * 名前を付けて「作成」をクリックします\n * Webアプリケーションの場合、承認されたリダイレクトURIに`http://localhost:3000/oauth2callback`を追加します。\n * クライアントのOAuthキーのJSONファイルをダウンロードします\n * キーファイルの名前を`gcp-oauth.keys.json`に変更します。\n\n2. 実行認証:\n\n 認証には 2 つの方法があります:\n\n a. グローバル認証（推奨）:\n\n ```bash\n # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder\n mkdir -p ~/.gmail-mcp\n mv gcp-oauth.keys.json ~/.gmail-mcp/\n\n # Run authentication from anywhere\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n b. ローカル認証:\n\n ```bash\n # Place gcp-oauth.keys.json in your current directory\n # The file will be automatically copied to global config\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n 認証プロセスは次のようになります。\n\n * 現在のディレクトリまたは`~/.gmail-mcp/`で`gcp-oauth.keys.json`を探します。\n * 現在のディレクトリで見つかった場合は、 `~/.gmail-mcp/`にコピーします。\n * Google認証用のデフォルトのブラウザを開きます\n * 資格情報を`~/.gmail-mcp/credentials.json`として保存します。\n\n > **注記**：\n >\n > * 認証が成功すると、認証情報は`~/.gmail-mcp/`にグローバルに保存され、どのディレクトリからでも使用できるようになります。\n > * デスクトップアプリと Web アプリケーションの両方の資格情報がサポートされています\n > * Webアプリケーションの認証情報の場合は、承認されたリダイレクトURIに`http://localhost:3000/oauth2callback`を追加してください。\n\n3. Claude Desktop で設定:\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n}\n```\n\n### Docker サポート\n\nDocker を使用する場合:\n\n1. 認証:\n\n```bash\ndocker run -i --rm \\\n --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \\\n -v mcp-gmail:/gmail-server \\\n -e GMAIL_OAUTH_PATH=/gcp-oauth.keys.json \\\n -e \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\" \\\n -p 3000:3000 \\\n mcp/gmail auth\n```\n\n2. 使用法：\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-v\",\n \"mcp-gmail:/gmail-server\",\n \"-e\",\n \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\",\n \"mcp/gmail\"\n ]\n }\n }\n}\n```\n\n### クラウドサーバー認証\n\nクラウドサーバー環境 (n8n など) では、認証時にカスタムコールバック URL を指定できます。\n\n```bash\nnpx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n```\n\n#### クラウド環境のセットアップ手順\n\n1. **リバースプロキシを構成する:**\n\n * 認証用のポートを公開するようにn8nコンテナを設定する\n * リバースプロキシを設定して、ドメイン（例： `gmail.gongrzhe.com` ）からのトラフィックをこのポートに転送します。\n\n2. **DNS 構成:**\n\n * DNS設定にAレコードを追加して、ドメインをクラウドサーバーのIPアドレスに解決します。\n\n3. **Google Cloud Platform のセットアップ:**\n\n * Google Cloud Console で、カスタムドメインコールバック URL（例: `https://gmail.gongrzhe.com/oauth2callback` ）を承認済みリダイレクト URI リストに追加します。\n\n4. **実行認証:**\n\n ```bash\n npx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n ```\n\n5. **アプリケーションで構成します:**\n\n ```json\n {\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n }\n ```\n\nこのアプローチにより、コンテナ化されたアプリケーションやクラウドサーバーなど、localhost にアクセスできない環境でも認証フローが適切に機能するようになります。\n\n## 利用可能なツール\n\nサーバーは、Claude Desktop を通じて使用できる次のツールを提供します。\n\n### 1. メールを送信する ( `send_email` )\n\n新しいメールをすぐに送信します。\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"cc\": [\"cc@example.com\"],\n \"bcc\": [\"bcc@example.com\"]\n}\n```\n\n### 2. 下書きメール（ `draft_email` ）\n\n電子メールを送信せずに下書きを作成します。\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Draft Report\",\n \"body\": \"Here's the draft report for your review.\",\n \"cc\": [\"manager@example.com\"]\n}\n```\n\n### 3. メールを読む ( `read_email` )\n\n特定の電子メールの内容をその ID で取得します。\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 4. メールを検索する（ `search_emails` ）\n\nGmail 検索構文を使用してメールを検索します。\n\n```json\n{\n \"query\": \"from:sender@example.com after:2024/01/01 has:attachment\",\n \"maxResults\": 10\n}\n```\n\n### 5. メールの変更 ( `modify_email` )\n\n電子メールにラベルを追加または削除します (別のフォルダーに移動、アーカイブなど)。\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\",\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"]\n}\n```\n\n### 6. メールを削除する（ `delete_email` ）\n\n電子メールを完全に削除します。\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 7. メールラベルの一覧表示（ `list_email_labels` ）\n\n利用可能なすべての Gmail ラベルを取得します。\n\n```json\n{}\n```\n\n### 8. ラベルを作成する ( `create_label` )\n\n新しい Gmail ラベルを作成します。\n\n```json\n{\n \"name\": \"Important Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 9. ラベルを更新する ( `update_label` )\n\n既存の Gmail ラベルを更新します。\n\n```json\n{\n \"id\": \"Label_1234567890\",\n \"name\": \"Urgent Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 10. ラベルの削除 ( `delete_label` )\n\nGmail ラベルを削除します。\n\n```json\n{\n \"id\": \"Label_1234567890\"\n}\n```\n\n### 11. ラベルを取得または作成する ( `get_or_create_label` )\n\n名前で既存のラベルを取得するか、存在しない場合は作成します。\n\n```json\n{\n \"name\": \"Project XYZ\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 12. メールの一括変更（ `batch_modify_emails` ）\n\n複数の電子メールのラベルを効率的に一括変更します。\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"],\n \"batchSize\": 50\n}\n```\n\n### 13. メールの一括削除（ `batch_delete_emails` ）\n\n複数の電子メールを効率的に一括して永久に削除します。\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"batchSize\": 50\n}\n```\n\n## 高度な検索構文\n\n`search_emails`ツールは、Gmail の強力な検索演算子をサポートしています。\n\n| オペレーター | 例 | 説明 |\n| ---------------- | ------------------------- | ------------------ |\n| `from:` | `from:john@example.com` | 特定の送信者からのメール |\n| `to:` | `to:mary@example.com` | 特定の受信者に送信されたメール |\n| `subject:` | `subject:\"meeting notes\"` | 件名に特定のテキストが含まれるメール |\n| `has:attachment` | `has:attachment` | 添付ファイル付きメール |\n| `after:` | `after:2024/01/01` | デート後に受信したメール |\n| `before:` | `before:2024/02/01` | デート前に受信したメール |\n| `is:` | `is:unread` | 特定の状態に関するメール |\n| `label:` | `label:work` | 特定のラベルが付いたメール |\n\n複数の演算子を組み合わせることができます: `from:john@example.com after:2024/01/01 has:attachment`\n\n## 高度な機能\n\n### メールコンテンツの抽出\n\nサーバーは複雑な MIME 構造から電子メールのコンテンツをインテリジェントに抽出します。\n\n* 利用可能な場合はプレーンテキストコンテンツを優先します\n* プレーンテキストが利用できない場合は HTML コンテンツにフォールバックします\n* ネストされた部分を持つマルチパートMIMEメッセージを処理します\n* 添付ファイルの情報（ファイル名、種類、サイズ）を処理します\n* 元のメールのヘッダー（送信元、宛先、件名、日付）を保持します\n\n### 国際文字サポート\n\nサーバーは、電子メールの件名と本文で、次のような非 ASCII 文字を完全にサポートします。\n\n* トルコ語、中国語、日本語、韓国語、その他の非ラテン文字\n* 特殊文字と記号\n* 適切なエンコードにより、メールクライアントで正しく表示されます\n\n### 包括的なラベル管理\n\nサーバーは、Gmail ラベルを管理するための完全なツールセットを提供します。\n\n* **ラベルの作成**: カスタマイズ可能な表示設定で新しいラベルを作成します\n* **ラベルを更新**: ラベルの名前を変更したり、表示設定を変更したりします\n* **ラベルの削除**: ユーザーが作成したラベルを削除します (システムラベルは保護されています)\n* **検索または作成**: 名前でラベルを取得するか、見つからない場合は自動的に作成します\n* **すべてのラベルを一覧表示**: すべてのシステムラベルとユーザーラベルを詳細情報とともに表示します。\n* **ラベルの表示オプション**: メッセージとラベルリストでのラベルの表示方法を制御します\n\nラベルの表示設定には次のものが含まれます。\n\n* `messageListVisibility` : ラベルがメッセージリストに表示されるかどうかを制御します ( `show`または`hide` )\n* `labelListVisibility` : ラベルリスト内でのラベルの表示方法を制御します ( `labelShow` 、 `labelShowIfUnread` 、または`labelHide` )\n\nこれらのラベル管理機能により、Gmail インターフェースに切り替えることなく、Claude から直接メールを高度に整理できます。\n\n### バッチ操作\n\nサーバーには効率的なバッチ処理機能が含まれています。\n\n* 一度に最大 50 件のメールを処理 (バッチサイズは設定可能)\n* API 制限を回避するために大量のメールセットを自動的にチャンク化します\n* 各操作の詳細な成功/失敗レポート\n* 個別の再試行による適切なエラー処理\n* 大量の受信トレイ管理や整理タスクに最適\n\n## セキュリティノート\n\n* OAuth 認証情報はローカル環境 ( `~/.gmail-mcp/` ) に安全に保存されます。\n* サーバーは永続的な認証を維持するためにオフラインアクセスを使用します\n* 資格情報をバージョン管理に共有したりコミットしたりしないでください\n* Google アカウント設定で定期的に使用していないアクセスを確認し、取り消してください\n* 認証情報はグローバルに保存されますが、現在のユーザーのみがアクセスできます。\n\n## トラブルシューティング\n\n1. **OAuthキーが見つかりません**\n\n * `gcp-oauth.keys.json`が現在のディレクトリまたは`~/.gmail-mcp/`にあることを確認してください。\n * ファイルの権限を確認する\n\n2. **資格情報の形式が無効です**\n\n * OAuthキーファイルに`web`または`installed`認証情報が含まれていることを確認します\n * Webアプリケーションの場合、リダイレクトURIが正しく設定されていることを確認します。\n\n3. **ポートはすでに使用されています**\n\n * ポート3000がすでに使用されている場合は、認証を実行する前にポートを解放してください。\n * そのポートを使用しているプロセスを見つけて停止することができます\n\n4. **バッチ操作の失敗**\n\n * バッチ操作が失敗した場合、個々の項目が自動的に再試行されます。\n * 具体的な障害については詳細なエラーメッセージを確認してください\n * レート制限に遭遇した場合はバッチサイズを減らすことを検討してください\n\n## 貢献\n\n貢献を歓迎します！お気軽にプルリクエストを送信してください。\n\n## 評価の実行\n\nevalsパッケージはmcpクライアントをロードし、index.tsファイルを実行するため、テスト間で再構築する必要はありません。npxコマンドの先頭に環境変数をロードすることもできます。完全なドキュメントは[こちらで](https://www.mcpevals.io/docs)ご覧いただけます。\n\n```bash\nOPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts\n```\n\n## ライセンス\n\nマサチューセッツ工科大学\n\n## サポート\n\n問題が発生した場合や質問がある場合は、GitHub リポジトリに問題を報告してください。","Japanese","ja-JP",{"_29":62,"_33":66,"_38":67},{"_31":63,"_33":64,"_35":65},"자동 인증 기능을 갖춘 Claude Desktop의 Gmail 통합 서버입니다. 이 서버를 통해 AI 비서가 자연어 상호작용을 통해 Gmail을 관리할 수 있습니다.","Gmail 자동 인증 MCP 서버","# Gmail 자동 인증 MCP 서버\n\nClaude Desktop에서 Gmail을 통합하고 자동 인증을 지원하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 비서가 자연어 상호작용을 통해 Gmail을 관리할 수 있습니다.\n\n![](https://badge.mcpx.dev?type=server) [![대장간 배지](https://smithery.ai/badge/@gongrzhe/server-gmail-autoauth-mcp)](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp)\n\n## 특징\n\n* 제목, 내용, 첨부 파일, 수신자를 지정하여 이메일을 보내세요\n* 제목 줄과 이메일 콘텐츠에서 국제 문자를 완벽하게 지원합니다.\n* 고급 MIME 구조 처리를 통해 ID로 이메일 메시지를 읽습니다.\n* 이메일 첨부 파일 정보(파일 이름, 유형, 크기) 보기\n* 다양한 기준(제목, 발신자, 날짜 범위)으로 이메일 검색\n* **레이블을 생성, 업데이트, 삭제 및 나열할 수 있는 기능을 갖춘 포괄적인 레이블 관리**\n* 사용 가능한 모든 Gmail 라벨(시스템 및 사용자 정의)을 나열합니다.\n* 받은 편지함, 보낸 편지함 또는 사용자 지정 레이블에 이메일 나열\n* 이메일을 읽음/읽지 않음으로 표시\n* 이메일을 다른 라벨/폴더로 이동\n* 이메일 삭제\n* **여러 이메일을 동시에 효율적으로 처리하기 위한 일괄 작업**\n* Gmail API와의 완벽한 통합\n* 자동 브라우저 실행을 통한 간단한 OAuth2 인증 흐름\n* 데스크톱 및 웹 애플리케이션 자격 증명 모두 지원\n* 편의성을 위한 글로벌 자격 증명 저장\n\n## 설치 및 인증\n\n### Smithery를 통해 설치\n\n[Smithery를](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp) 통해 Claude Desktop용 Gmail AutoAuth를 자동으로 설치하려면 다음을 수행하세요.\n\n지엑스피1\n\n### 수동 설치\n\n1. Google Cloud 프로젝트를 만들고 자격 증명을 얻으세요.\n\n a. Google Cloud 프로젝트 만들기:\n\n * [Google Cloud Console](https://console.cloud.google.com/) 로 이동\n * 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요\n * 프로젝트에 Gmail API를 활성화하세요\n\n b. OAuth 2.0 자격 증명을 생성합니다.\n\n * \"API 및 서비스\" > \"자격 증명\"으로 이동하세요.\n * \"자격 증명 만들기\" > \"OAuth 클라이언트 ID\"를 클릭하세요.\n * 애플리케이션 유형으로 \"데스크톱 앱\" 또는 \"웹 애플리케이션\"을 선택하세요.\n * 이름을 지정하고 \"만들기\"를 클릭하세요.\n * 웹 애플리케이션의 경우 권한이 부여된 리디렉션 URI에 `http://localhost:3000/oauth2callback` 추가합니다.\n * 클라이언트의 OAuth 키 JSON 파일을 다운로드하세요.\n * 키 파일의 이름을 `gcp-oauth.keys.json` 으로 바꾸세요.\n\n2. 인증 실행:\n\n 두 가지 방법으로 인증할 수 있습니다.\n\n a. 글로벌 인증(권장):\n\n ```bash\n # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder\n mkdir -p ~/.gmail-mcp\n mv gcp-oauth.keys.json ~/.gmail-mcp/\n\n # Run authentication from anywhere\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n b. 로컬 인증:\n\n ```bash\n # Place gcp-oauth.keys.json in your current directory\n # The file will be automatically copied to global config\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n 인증 과정은 다음과 같습니다.\n\n * 현재 디렉토리 또는 `~/.gmail-mcp/` 에서 `gcp-oauth.keys.json` 찾으세요.\n * 현재 디렉토리에서 발견되면 `~/.gmail-mcp/` 로 복사하세요.\n * Google 인증을 위해 기본 브라우저를 엽니다.\n * 자격 증명을 `~/.gmail-mcp/credentials.json` 으로 저장합니다.\n\n > **메모** :\n >\n > * 인증에 성공하면 자격 증명은 `~/.gmail-mcp/` 에 전역적으로 저장되며 모든 디렉토리에서 사용할 수 있습니다.\n > * 데스크톱 앱과 웹 애플리케이션 자격 증명이 모두 지원됩니다.\n > * 웹 애플리케이션 자격 증명의 경우 권한이 있는 리디렉션 URI에 `http://localhost:3000/oauth2callback` 추가해야 합니다.\n\n3. Claude Desktop에서 구성:\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n}\n```\n\n### 도커 지원\n\nDocker를 사용하는 것을 선호하는 경우:\n\n1. 입증:\n\n```bash\ndocker run -i --rm \\\n --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \\\n -v mcp-gmail:/gmail-server \\\n -e GMAIL_OAUTH_PATH=/gcp-oauth.keys.json \\\n -e \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\" \\\n -p 3000:3000 \\\n mcp/gmail auth\n```\n\n2. 용법:\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-v\",\n \"mcp-gmail:/gmail-server\",\n \"-e\",\n \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\",\n \"mcp/gmail\"\n ]\n }\n }\n}\n```\n\n### 클라우드 서버 인증\n\n클라우드 서버 환경(예: n8n)의 경우 인증 중에 사용자 지정 콜백 URL을 지정할 수 있습니다.\n\n```bash\nnpx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n```\n\n#### 클라우드 환경 설정 지침\n\n1. **역방향 프록시 구성:**\n\n * 인증을 위한 포트를 노출하도록 n8n 컨테이너를 설정하세요.\n * 도메인(예: `gmail.gongrzhe.com` )에서 이 포트로 트래픽을 전달하기 위해 역방향 프록시를 구성합니다.\n\n2. **DNS 구성:**\n\n * DNS 설정에 A 레코드를 추가하여 도메인을 클라우드 서버의 IP 주소로 확인하세요.\n\n3. **Google Cloud Platform 설정:**\n\n * Google Cloud Console에서 사용자 지정 도메인 콜백 URL(예: `https://gmail.gongrzhe.com/oauth2callback` )을 승인된 리디렉션 URI 목록에 추가합니다.\n\n4. **인증 실행:**\n\n ```bash\n npx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n ```\n\n5. **애플리케이션에서 구성:**\n\n ```json\n {\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n }\n ```\n\n이 접근 방식을 사용하면 컨테이너화된 애플리케이션이나 클라우드 서버와 같이 로컬호스트에 액세스할 수 없는 환경에서도 인증 흐름이 제대로 작동할 수 있습니다.\n\n## 사용 가능한 도구\n\n이 서버는 Claude Desktop을 통해 사용할 수 있는 다음과 같은 도구를 제공합니다.\n\n### 1. 이메일 보내기( `send_email` )\n\n새로운 이메일을 즉시 보냅니다.\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"cc\": [\"cc@example.com\"],\n \"bcc\": [\"bcc@example.com\"]\n}\n```\n\n### 2. 초안 이메일( `draft_email` )\n\n이메일을 보내지 않고 임시 이메일을 작성합니다.\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Draft Report\",\n \"body\": \"Here's the draft report for your review.\",\n \"cc\": [\"manager@example.com\"]\n}\n```\n\n### 3. 이메일 읽기( `read_email` )\n\nID로 특정 이메일의 내용을 검색합니다.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 4. 이메일 검색( `search_emails` )\n\nGmail 검색 구문을 사용하여 이메일을 검색합니다.\n\n```json\n{\n \"query\": \"from:sender@example.com after:2024/01/01 has:attachment\",\n \"maxResults\": 10\n}\n```\n\n### 5. 이메일 수정( `modify_email` )\n\n이메일에 라벨을 추가하거나 제거합니다(다른 폴더로 이동, 보관 등).\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\",\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"]\n}\n```\n\n### 6. 이메일 삭제( `delete_email` )\n\n이메일을 영구적으로 삭제합니다.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 7. 이메일 라벨 목록( `list_email_labels` )\n\n사용 가능한 모든 Gmail 라벨을 검색합니다.\n\n```json\n{}\n```\n\n### 8. 라벨 생성( `create_label` )\n\n새로운 Gmail 라벨을 만듭니다.\n\n```json\n{\n \"name\": \"Important Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 9. 레이블 업데이트( `update_label` )\n\n기존 Gmail 라벨을 업데이트합니다.\n\n```json\n{\n \"id\": \"Label_1234567890\",\n \"name\": \"Urgent Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 10. 라벨 삭제( `delete_label` )\n\nGmail 라벨을 삭제합니다.\n\n```json\n{\n \"id\": \"Label_1234567890\"\n}\n```\n\n### 11. 레이블 가져오기 또는 만들기( `get_or_create_label` )\n\n이름으로 기존 레이블을 가져오거나 레이블이 없으면 새로 만듭니다.\n\n```json\n{\n \"name\": \"Project XYZ\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 12. 이메일 일괄 수정( `batch_modify_emails` )\n\n여러 이메일의 라벨을 효율적으로 일괄 처리하여 수정합니다.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"],\n \"batchSize\": 50\n}\n```\n\n### 13. 이메일 일괄 삭제( `batch_delete_emails` )\n\n여러 개의 이메일을 효율적으로 일괄적으로 영구 삭제합니다.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"batchSize\": 50\n}\n```\n\n## 고급 검색 구문\n\n`search_emails` 도구는 Gmail의 강력한 검색 연산자를 지원합니다.\n\n| 연산자 | 예 | 설명 |\n| ---------------- | ------------------------- | ------------------- |\n| `from:` | `from:john@example.com` | 특정 발신자의 이메일 |\n| `to:` | `to:mary@example.com` | 특정 수신자에게 전송된 이메일 |\n| `subject:` | `subject:\"meeting notes\"` | 제목에 특정 텍스트가 포함된 이메일 |\n| `has:attachment` | `has:attachment` | 첨부 파일이 있는 이메일 |\n| `after:` | `after:2024/01/01` | 특정 날짜 이후에 수신된 이메일 |\n| `before:` | `before:2024/02/01` | 날짜 전에 받은 이메일 |\n| `is:` | `is:unread` | 특정 상태가 포함된 이메일 |\n| `label:` | `label:work` | 특정 라벨이 있는 이메일 |\n\n여러 연산자를 결합할 수 있습니다: `from:john@example.com after:2024/01/01 has:attachment`\n\n## 고급 기능\n\n### 이메일 콘텐츠 추출\n\n서버는 복잡한 MIME 구조에서 이메일 콘텐츠를 지능적으로 추출합니다.\n\n* 사용 가능한 경우 일반 텍스트 콘텐츠를 우선시합니다.\n* 일반 텍스트를 사용할 수 없는 경우 HTML 콘텐츠로 돌아갑니다.\n* 중첩된 부분이 있는 다중 부분 MIME 메시지를 처리합니다.\n* 첨부 파일 정보(파일 이름, 유형, 크기)를 처리합니다.\n* 원본 이메일 헤더(보낸 사람, 받는 사람, 제목, 날짜)를 보존합니다.\n\n### 국제 문자 지원\n\n이 서버는 다음을 포함하여 이메일 제목과 내용에서 ASCII가 아닌 문자를 완벽하게 지원합니다.\n\n* 터키어, 중국어, 일본어, 한국어 및 기타 비 라틴 문자 알파벳\n* 특수 문자 및 기호\n* 적절한 인코딩은 이메일 클라이언트에서 올바른 표시를 보장합니다.\n\n### 포괄적인 라벨 관리\n\n이 서버는 Gmail 라벨을 관리하기 위한 완전한 도구 세트를 제공합니다.\n\n* **레이블 만들기** : 사용자 정의 가능한 가시성 설정으로 새 레이블을 만듭니다.\n* **레이블 업데이트** : 레이블 이름을 바꾸거나 표시 설정을 변경합니다.\n* **레이블 삭제** : 사용자가 만든 레이블을 제거합니다(시스템 레이블은 보호됨)\n* **찾기 또는 만들기** : 이름으로 레이블을 가져오거나 찾을 수 없는 경우 자동으로 만듭니다.\n* **모든 레이블 나열** : 자세한 정보와 함께 모든 시스템 및 사용자 레이블을 봅니다.\n* **레이블 표시 옵션** : 메시지 및 레이블 목록에 레이블이 표시되는 방식을 제어합니다.\n\n라벨 표시 설정에는 다음이 포함됩니다.\n\n* `messageListVisibility` : 메시지 목록에 레이블이 나타나는지( `show` 또는 `hide` ) 여부를 제어합니다.\n* `labelListVisibility` : 레이블 목록에 레이블이 표시되는 방식( `labelShow` , `labelShowIfUnread` 또는 `labelHide` )을 제어합니다.\n\n이러한 라벨 관리 기능을 사용하면 Gmail 인터페이스로 전환하지 않고도 Claude를 통해 직접 이메일을 정교하게 구성할 수 있습니다.\n\n### 배치 작업\n\n서버에는 효율적인 일괄 처리 기능이 포함되어 있습니다.\n\n* 최대 50개의 이메일을 한 번에 처리합니다(배치 크기 설정 가능)\n* API 제한을 피하기 위해 대용량 이메일 세트를 자동으로 청킹합니다.\n* 각 작업에 대한 자세한 성공/실패 보고\n* 개별 재시도를 통한 우아한 오류 처리\n* 대량 받은 편지함 관리 및 구성 작업에 적합합니다.\n\n## 보안 참고 사항\n\n* OAuth 자격 증명은 로컬 환경( `~/.gmail-mcp/` )에 안전하게 저장됩니다.\n* 서버는 오프라인 액세스를 사용하여 지속적인 인증을 유지합니다.\n* 버전 제어에 자격 증명을 공유하거나 커밋하지 마십시오.\n* Google 계정 설정에서 사용하지 않는 액세스 권한을 정기적으로 검토하고 취소하세요.\n* 자격 증명은 전역적으로 저장되지만 현재 사용자만 액세스할 수 있습니다.\n\n## 문제 해결\n\n1. **OAuth 키를 찾을 수 없습니다**\n\n * `gcp-oauth.keys.json` 이 현재 디렉토리 또는 `~/.gmail-mcp/` 에 있는지 확인하세요.\n * 파일 권한 확인\n\n2. **잘못된 자격 증명 형식**\n\n * OAuth 키 파일에 `web` 또는 `installed` 자격 증명이 포함되어 있는지 확인하세요.\n * 웹 애플리케이션의 경우 리디렉션 URI가 올바르게 구성되었는지 확인하세요.\n\n3. **포트가 이미 사용 중입니다**\n\n * 포트 3000이 이미 사용 중이면 인증을 실행하기 전에 포트를 비워주세요.\n * 해당 포트를 사용하여 프로세스를 찾아 중지할 수 있습니다.\n\n4. **배치 작업 실패**\n\n * 일괄 작업이 실패하면 개별 항목을 자동으로 다시 시도합니다.\n * 특정 실패에 대한 자세한 오류 메시지를 확인하세요.\n * 속도 제한이 발생하는 경우 배치 크기를 줄이는 것을 고려하세요.\n\n## 기여하다\n\n기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.\n\n## 실행 평가\n\nevals 패키지는 index.ts 파일을 실행하는 mcp 클라이언트를 로드하므로 테스트 사이에 다시 빌드할 필요가 없습니다. npx 명령 앞에 접두사를 붙여 환경 변수를 로드할 수 있습니다. 전체 문서는 [여기에서](https://www.mcpevals.io/docs) 확인할 수 있습니다.\n\n```bash\nOPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts\n```\n\n## 특허\n\nMIT\n\n## 지원하다\n\n문제가 발생하거나 질문이 있는 경우 GitHub 저장소에 문제를 제출하세요.","Korean","ko-KR",{"_29":69,"_33":73,"_38":74},{"_31":70,"_33":71,"_35":72},"Сервер для интеграции Gmail в Claude Desktop с поддержкой автоматической аутентификации. Этот сервер позволяет помощникам ИИ управлять Gmail посредством взаимодействия на естественном языке.","Gmail AutoAuth MCP-сервер","# Gmail AutoAuth MCP-сервер\n\nСервер Model Context Protocol (MCP) для интеграции Gmail в Claude Desktop с поддержкой автоматической аутентификации. Этот сервер позволяет помощникам ИИ управлять Gmail посредством взаимодействия на естественном языке.\n\n![](https://badge.mcpx.dev?type=server) [![значок кузнеца](https://smithery.ai/badge/@gongrzhe/server-gmail-autoauth-mcp)](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp)\n\n## Функции\n\n* Отправка электронных писем с темой, содержанием, вложениями и получателями\n* Поддержка HTML-писем и многокомпонентных сообщений с версиями HTML и обычного текста\n* Полная поддержка международных символов в темах и содержимом писем\n* Чтение сообщений электронной почты по идентификатору с расширенной обработкой структуры MIME\n* Просмотр информации о вложениях электронной почты (имена файлов, типы, размеры)\n* Поиск писем по различным критериям (тема, отправитель, диапазон дат)\n* **Комплексное управление этикетками с возможностью создания, обновления, удаления и составления списка этикеток**\n* Список всех доступных ярлыков Gmail (системных и пользовательских)\n* Список писем в папке «Входящие», «Отправленные» ��ли с пользовательскими метками\n* Отметить письма как прочитанные/непрочитанные\n* Перемещать электронные письма в разные метки/папки\n* Удалить электронные письма\n* **Пакетные операции для эффективной обработки нескольких писем одновременно**\n* Полная интеграция с API Gmail\n* Простой процесс аутентификации OAuth2 с автоматическим запуском браузера\n* Поддержка учетных данных как настольных, так и веб-приложений\n* Глобальное хранилище учетных данных для удобства\n\n## Установка и аутентификация\n\n### Установка через Smithery\n\nЧтобы автоматически установить Gmail AutoAuth для Claude Desktop через [Smithery](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp) :\n\n```bash\nnpx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude\n```\n\n### Установка вручную\n\n1. Создайте проект Google Cloud и получите учетные данные:\n\n а. Создайте проект Google Cloud:\n\n * Перейти в [Google Cloud Console](https://console.cloud.google.com/)\n * Создайте новый проект или выберите существующий\n * Включите API Gmail для вашего проекта\n\n б) Создайте учетные данные OAuth 2.0:\n\n * Перейдите в раздел «API и службы» > «Учетные данные».\n * Нажмите «Создать учетные данные» > «Идентификатор клиента OAuth».\n * Выберите тип приложения: «Приложение для настольного компьютера» или «Веб-приложение».\n * Дайте ему имя и нажмите «Создать».\n * Для веб-приложения добавьте `http://localhost:3000/oauth2callback` к разрешенным URI перенаправления.\n * Загрузите JSON-файл ключей OAuth вашего клиента\n * Переименуйте файл ключа в `gcp-oauth.keys.json`\n\n2. Запустить аутентификацию:\n\n Аутентификацию можно пройти двумя способами:\n\n а. Глобальная аутентификация (рекомендуется):\n\n ```bash\n # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder\n mkdir -p ~/.gmail-mcp\n mv gcp-oauth.keys.json ~/.gmail-mcp/\n\n # Run authentication from anywhere\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n б) Локальная аутентификация:\n\n ```bash\n # Place gcp-oauth.keys.json in your current directory\n # The file will be automatically copied to global config\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n Процесс аутентификации будет:\n\n * Найдите `gcp-oauth.keys.json` в текущем каталоге или `~/.gmail-mcp/`\n * Если файл найден в текущем каталоге, скопируйте его в `~/.gmail-mcp/`\n * Откройте браузер по умолчанию для аутентификации Google\n * Сохраните учетные данные как `~/.gmail-mcp/credentials.json`\n\n > **Примечание** :\n >\n > * После успешной аутентификации учетные данные сохраняются глобально в `~/.gmail-mcp/` и могут быть использованы из любого каталога.\n > * Поддерживаются учетные данные как настольного приложения, так и веб-приложения.\n > * Для учетных данных веб-приложения обязательно добавьте `http://localhost:3000/oauth2callback` к вашим авторизованным URI перенаправления.\n\n3. Настройте в Claude Desktop:\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n}\n```\n\n### Поддержка докера\n\nЕсли вы предпочитаете использовать Docker:\n\n1. Аутентификация:\n\n```bash\ndocker run -i --rm \\\n --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \\\n -v mcp-gmail:/gmail-server \\\n -e GMAIL_OAUTH_PATH=/gcp-oauth.keys.json \\\n -e \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\" \\\n -p 3000:3000 \\\n mcp/gmail auth\n```\n\n2. Использование:\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-v\",\n \"mcp-gmail:/gmail-server\",\n \"-e\",\n \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\",\n \"mcp/gmail\"\n ]\n }\n }\n}\n```\n\n### Аутентификация облачного сервера\n\nДля облачных серверных сред (например, n8n) вы можете указать пользовательский URL-адрес обратного вызова во время аутентификации:\n\n```bash\nnpx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n```\n\n#### Инструкции по настройке облачной среды\n\n1. **Настроить обратный прокси-сервер:**\n\n * Настройте контейнер n8n для предоставления порта для аутентификации\n * Настройте обратный прокси-сервер для пересылки трафика с вашего домена (например, `gmail.gongrzhe.com` ) на этот порт\n\n2. **Конфигурация DNS:**\n\n * Добавьте запись A в настройки DNS, чтобы преобразовать ваш домен в IP-адрес вашего облачного сервера.\n\n3. **Настройка облачной платформы Google:**\n\n * В консоли Google Cloud Console добавьте URL-адрес обратного вызова вашего домена (например, `https://gmail.gongrzhe.com/oauth2callback` ) в список разрешенных URI перенаправления.\n\n4. **Запустить аутентификацию:**\n\n ```bash\n npx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n ```\n\n5. **Настройте в своем приложении:**\n\n ```json\n {\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n }\n ```\n\nТакой подход позволяет потокам аутентификации работать должным образом в средах, где локальный хост недоступен, например, в контейнеризированных приложениях или облачных серверах.\n\n## Доступные инструменты\n\nСервер предоставляет следующие инструменты, которые можно использовать через Claude Desktop:\n\n### 1. Отправить электронное письмо ( `send_email` )\n\nНемедленно отправляет новое письмо. Поддерживает простой текст, HTML или многокомпонентные письма.\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"cc\": [\"cc@example.com\"],\n \"bcc\": [\"bcc@example.com\"],\n \"mimeType\": \"text/plain\"\n}\n\n```\n\nПример HTML-письма:\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"mimeType\": \"text/html\",\n \"body\": \"

Meeting Reminder

Just a reminder about our meeting tomorrow at 10 AM.

Best regards

\"\n}\n```\n\nПример составного электронного письма (HTML + обычный текст):\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"mimeType\": \"multipart/alternative\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"htmlBody\": \"

Meeting Reminder

Just a reminder about our meeting tomorrow at 10 AM.

Best regards

\"\n}\n```\n\n### 2. Черновик электронного письма ( `draft_email` )\n\nСоздает черновик электронного письма, не отправляя его.\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Draft Report\",\n \"body\": \"Here's the draft report for your review.\",\n \"cc\": [\"manager@example.com\"]\n}\n```\n\n### 3. Прочитать письмо ( `read_email` )\n\nИзвлекает содержимое определенного электронного письма по его идентификатору.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 4. Поиск писем ( `search_emails` )\n\nПоиск писем с использованием синтаксиса поиска Gmail.\n\n```json\n{\n \"query\": \"from:sender@example.com after:2024/01/01 has:attachment\",\n \"maxResults\": 10\n}\n```\n\n### 5. Изменить адрес электронной почты ( `modify_email` )\n\nДобавляет или удаляет метки из писем (перемещать в другие папки, архивировать и т. д.).\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\",\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"]\n}\n```\n\n### 6. Удалить электронное письмо ( `delete_email` )\n\nУдаляет электронное письмо навсегда.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 7. Список меток электронной почты ( `list_email_labels` )\n\nИзвлекает все доступные ярлыки Gmail.\n\n```json\n{}\n```\n\n### 8. Создать метку ( `create_label` )\n\nСоздает новый ярлык Gmail.\n\n```json\n{\n \"name\": \"Important Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 9. Обновить метку ( `update_label` )\n\nОбновляет существующий ярлык Gmail.\n\n```json\n{\n \"id\": \"Label_1234567890\",\n \"name\": \"Urgent Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 10. Удалить метку ( `delete_label` )\n\nУдаляет ярлык Gmail.\n\n```json\n{\n \"id\": \"Label_1234567890\"\n}\n```\n\n### 11. Получить или создать метку ( `get_or_create_label` )\n\nПолучает существующую метку по имени или создает ее, если она не существует.\n\n```json\n{\n \"name\": \"Project XYZ\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 12. Пакетное изменение писем ( `batch_modify_emails` )\n\nЭффективно изменяет метки для нескольких писем пакетами.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"],\n \"batchSize\": 50\n}\n```\n\n### 13. Пакетное удаление писем ( `batch_delete_emails` )\n\nОкончательно удаляет несколько писем эффективными пакетами.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"batchSize\": 50\n}\n```\n\n## Синтаксис расширенного поиска\n\nИнструмент `search_emails` поддерживает мощные операторы поиска Gmail:\n\n| Оператор | Пример | Описание |\n| ---------------- | ------------------------- | --------------------------------------------- |\n| `from:` | `from:john@example.com` | Письма от определенного отправителя |\n| `to:` | `to:mary@example.com` | Письма, отправленные определенному получателю |\n| `subject:` | `subject:\"meeting notes\"` | Письма с определенным текстом в теме |\n| `has:attachment` | `has:attachment` | Письма с вложениями |\n| `after:` | `after:2024/01/01` | Письма, полученные после свидания |\n| `before:` | `before:2024/02/01` | Письма, полученные до даты |\n| `is:` | `is:unread` | Письма с определенным статусом |\n| `label:` | `label:work` | Письма с определенной меткой |\n\nВы можете объединить несколько операторов: `from:john@example.com after:2024/01/01 has:attachment`\n\n## Расширенные функции\n\n### Извлечение содержимого электронной почты\n\nСервер интеллектуально извлекает содержимое электронной почты из сложных структур MIME:\n\n* Приоритет отдается обычному текстовому контенту, если он доступен\n* Возвращается к HTML-контенту, если простой текст недоступен\n* Обрабатывает многокомпонентные сообщения MIME с вложенными частями\n* Обрабатывает информацию о вложениях (имя файла, тип, размер)\n* Сохраняет оригинальные заголовки писем (От, Кому, Тема, Дата)\n\n### Поддержка международного характера\n\nСервер полностью поддерживает символы, не входящие в набор ASCII, в темах и содержимом электронных писем, включая:\n\n* Турецкий, китайский, японский, корейский и другие нелатинские алфавиты\n* Специальные знаки и символы\n* Правильная кодировка обеспечивает корректное отображение в почтовых клиентах.\n\n### Комплексное управление этикетками\n\nСервер предоставляет полный набор инструментов для управления ярлыками Gmail:\n\n* **Создание меток** : создание новых меток с настраиваемыми параметрами видимости.\n* **Обновление меток** : переименование меток или изменение настроек их видимости.\n* **Удалить метки** : удалить метки, созданные пользователем (системные метки защищены)\n* **Найти или создать** : получить метку по имени или автоматически создать ее, если она не найдена\n* **Список всех меток** : просмотр всех системных и пользовательских меток с подробной информацией.\n* **Параметры видимости меток** : управление отображением меток в сообщениях и списках меток.\n\nНастройки видимости меток включают в себя:\n\n* `messageListVisibility` : управляет отображением метки в списке сообщений ( `show` или `hide` )\n* `labelListVisibility` : управляет тем, как отображается метка в списке меток ( `labelShow` , `labelShowIfUnread` или `labelHide` ).\n\nЭти функции управления ярлыками позволяют осуществлять сложную организацию электронных писем непосредственно через Claude, без необходимости переключения на интерфейс Gmail.\n\n### Пакетные операции\n\nСервер включает в себя эффективные возможности пакетной обработки:\n\n* Обрабатывать до 50 писем одновременно (размер пакета можно настраивать)\n* Автоматическое разделение больших наборов электронных писем на части для обхода ограничений API\n* Подробный отчет об успехах/неудачах для каждой операции\n* Грамотная обработка ошибок с индивидуальными повторными попытками\n* Идеально подходит для управления массовыми входящими сообщениями и задач по организации\n\n## Заметки о безопасности\n\n* Учетные данные OAuth надежно хранятся в вашей локальной среде ( `~/.gmail-mcp/` )\n* Сервер использует автономный доступ для поддержания постоянной аутентификации.\n* Никогда не передавайте и не передавайте свои учетные данные в систему контроля версий.\n* Регулярно проверяйте и отзывайте неиспользуемый доступ в настройках вашего аккаунта Google.\n* Учетные данные хранятся глобально, но доступны только текущему пользователю.\n\n## Поиск неисправностей\n\n1. **Ключи OAuth не найдены**\n\n * Убедитесь, что `gcp-oauth.keys.json` находится либо в вашем текущем каталоге, либо в `~/.gmail-mcp/`\n * Проверьте права доступа к файлу\n\n2. **Неверный формат учетных данных**\n\n * Убедитесь, что ваш файл ключей OAuth содержит `web` или `installed` учетные данные.\n * Для веб-приложений проверьте правильность настройки URI перенаправления.\n\n3. **Порт уже используется**\n\n * Если порт 3000 уже используется, освободите его перед запуском аутентификации.\n * Вы можете найти и остановить процесс, используя этот порт.\n\n4. **Сбои пакетной обработки**\n\n * Если пакетные операции не выполняются, они автоматически повторяют отдельные элементы.\n * Проверьте подробные сообщения об ошибках на предмет конкретных сбоев.\n * Рассмотрите возможность уменьшения размера партии, если вы столкнулись с ограничением скорости.\n\n## Внося вклад\n\nВклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.\n\n## Запуск оценок\n\nПакет evals загружает клиент mcp, который затем запускает файл index.ts, поэтому нет необходимости перестраиваться между тестами. Вы можете загрузить переменные среды, указав префикс команды npx. Полную документацию можно найти [здесь](https://www.mcpevals.io/docs) .\n\n```bash\nOPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts\n```\n\n## Лицензия\n\nМассачусетский технологический институт\n\n## Поддерживать\n\nЕсли у вас возникли какие-либо проблемы или есть вопросы, пожалуйста, сообщите о проблеме в репозитории GitHub.","Russian","ru-RU",{"_29":76,"_33":80,"_38":81},{"_31":77,"_33":78,"_35":79},"Claude Desktop 中集成 Gmail 的服务器，支持自动身份验证。该服务器使 AI 助手能够通过自然语言交互管理 Gmail。","Gmail 自动认证 MCP 服务器","# Gmail 自动认证 MCP 服务器\n\n一个用于在 Claude Desktop 中集成 Gmail 的模型上下文协议 (MCP) 服务器，并支持自动身份验证。该服务器使 AI 助手能够通过自然语言交互来管理 Gmail。\n\n![](https://badge.mcpx.dev?type=server) [![铁匠徽章](https://smithery.ai/badge/@gongrzhe/server-gmail-autoauth-mcp)](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp)\n\n## 特征\n\n* 发送包含主题、内容、附件和收件人的电子邮件\n* 完全支持主题行和电子邮件内容中的国际字符\n* 使用高级 MIME 结构处理按 ID 读取电子邮件消息\n* 查看电子邮件附件信息（文件名、类型、大小）\n* 使用各种条件（主题、发件人、日期范围）搜索电子邮件\n* **全面的标签管理，能够创建、更新、删除和列出标签**\n* 列出所有可用的 Gmail 标签（系统和用户定义）\n* 列出收件箱、已发送或自定义标签中的电子邮件\n* 将电子邮件标记为已读/未读\n* 将电子邮件移动到不同的标签/文件夹\n* 删除电子邮件\n* **批量操作可同时高效处理多封电子邮件**\n* 与 Gmail API 完全集成\n* 具有自动浏览器启动功能的简单 OAuth2 身份验证流程\n* 支持桌面和 Web 应用程序凭证\n* 全球凭证存储，方便快捷\n\n## 安装和认证\n\n### 通过 Smithery 安装\n\n要通过[Smithery](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp)自动为 Claude Desktop 安装 Gmail AutoAuth：\n\n```bash\nnpx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude\n```\n\n### 手动安装\n\n1. 创建 Google Cloud 项目并获取凭据：\n\n a.创建 Google Cloud 项目：\n\n * 前往[Google Cloud Console](https://console.cloud.google.com/)\n * 创建新项目或选择现有项目\n * 为您的项目启用 Gmail API\n\n b.创建 OAuth 2.0 凭证：\n\n * 前往“API 和服务”>“凭证”\n * 点击“创建凭证”>“OAuth 客户端 ID”\n * 选择“桌面应用程序”或“Web 应用程序”作为应用程序类型\n * 命名并点击“创建”\n * 对于 Web 应用程序，将`http://localhost:3000/oauth2callback`添加到授权重定向 URI\n * 下载客户端 OAuth 密钥的 JSON 文件\n * 将密钥文件重命名为`gcp-oauth.keys.json`\n\n2. 运行身份验证：\n\n 您可以通过两种方式进行身份验证：\n\n a.全局认证（推荐）：\n\n ```bash\n # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder\n mkdir -p ~/.gmail-mcp\n mv gcp-oauth.keys.json ~/.gmail-mcp/\n\n # Run authentication from anywhere\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n b. 本地身份验证：\n\n ```bash\n # Place gcp-oauth.keys.json in your current directory\n # The file will be automatically copied to global config\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n 身份验证过程将：\n\n * 在当前目录或`~/.gmail-mcp/`中查找`gcp-oauth.keys.json`\n * 如果在当前目录中找到，则将其复制到`~/.gmail-mcp/`\n * 打开默认浏览器进行 Google 身份验证\n * 将凭据保存为`~/.gmail-mcp/credentials.json`\n\n > **笔记**：\n >\n > * 身份验证成功后，凭据将全局存储在`~/.gmail-mcp/`中，可从任何目录使用\n > * 支持桌面应用程序和 Web 应用程序凭据\n > * 对于 Web 应用程序凭证，请确保将`http://localhost:3000/oauth2callback`添加到授权重定向 URI\n\n3. 在 Claude Desktop 中配置：\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n}\n```\n\n### Docker 支持\n\n如果您更喜欢使用 Docker：\n\n1. 验证：\n\n```bash\ndocker run -i --rm \\\n --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \\\n -v mcp-gmail:/gmail-server \\\n -e GMAIL_OAUTH_PATH=/gcp-oauth.keys.json \\\n -e \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\" \\\n -p 3000:3000 \\\n mcp/gmail auth\n```\n\n2. 用法：\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-v\",\n \"mcp-gmail:/gmail-server\",\n \"-e\",\n \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\",\n \"mcp/gmail\"\n ]\n }\n }\n}\n```\n\n### 云服务器认证\n\n对于云服务器环境（如 n8n），您可以在身份验证期间指定自定义回调 URL：\n\n```bash\nnpx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n```\n\n#### 云环境设置说明\n\n1. **配置反向代理：**\n\n * 设置 n8n 容器以公开用于身份验证的端口\n * 配置反向代理，将来自您的域（例如`gmail.gongrzhe.com` ）的流量转发到此端口\n\n2. **DNS配置：**\n\n * 在您的 DNS 设置中添加 A 记录，以将您的域名解析为云服务器的 IP 地址\n\n3. **Google云平台设置：**\n\n * 在您的 Google Cloud Console 中，将您的自定义域名回调 URL（例如`https://gmail.gongrzhe.com/oauth2callback` ）添加到授权重定向 URI 列表\n\n4. **运行身份验证：**\n\n ```bash\n npx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n ```\n\n5. **在您的应用程序中配置：**\n\n ```json\n {\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n }\n ```\n\n这种方法允许身份验证流程在无法访问本地主机的环境中正常工作，例如容器化应用程序或云服务器。\n\n## 可用工具\n\n服务器提供了以下可以通过Claude Desktop使用的工具：\n\n### 1.发送电子邮件（ `send_email` ）\n\n立即发送新电子邮件。\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"cc\": [\"cc@example.com\"],\n \"bcc\": [\"bcc@example.com\"]\n}\n```\n\n### 2. 草稿电子邮件（ `draft_email` ）\n\n创建电子邮件草稿但不发送。\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Draft Report\",\n \"body\": \"Here's the draft report for your review.\",\n \"cc\": [\"manager@example.com\"]\n}\n```\n\n### 3.阅读电子邮件（ `read_email` ）\n\n通过 ID 检索特定电子邮件的内容。\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 4. 搜索电子邮件（ `search_emails` ）\n\n使用 Gmail 搜索语法搜索电子邮件。\n\n```json\n{\n \"query\": \"from:sender@example.com after:2024/01/01 has:attachment\",\n \"maxResults\": 10\n}\n```\n\n### 5.修改邮箱（ `modify_email` ）\n\n在电子邮件中添加或删除标签（移动到不同的文件夹、存档等）。\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\",\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"]\n}\n```\n\n### 6.删除电子邮件（ `delete_email` ）\n\n永久删除电子邮件。\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 7. 列出电子邮件标签（ `list_email_labels` ）\n\n检索所有可用的 Gmail 标签。\n\n```json\n{}\n```\n\n### 8.创建标签（ `create_label` ）\n\n创建新的 Gmail 标签。\n\n```json\n{\n \"name\": \"Important Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 9.更新标签（ `update_label` ）\n\n更新现有的 Gmail 标签。\n\n```json\n{\n \"id\": \"Label_1234567890\",\n \"name\": \"Urgent Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 10.删除标签（ `delete_label` ）\n\n删除 Gmail 标签。\n\n```json\n{\n \"id\": \"Label_1234567890\"\n}\n```\n\n### 11. 获取或创建标签（ `get_or_create_label` ）\n\n通过名称获取现有标签，如果不存在则创建它。\n\n```json\n{\n \"name\": \"Project XYZ\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 12. 批量修改邮件（ `batch_modify_emails` ）\n\n高效批量修改多封电子邮件的标签。\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"],\n \"batchSize\": 50\n}\n```\n\n### 13. 批量删除邮件（ `batch_delete_emails` ）\n\n高效地批量永久删除多封电子邮件。\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"batchSize\": 50\n}\n```\n\n## 高级搜索语法\n\n`search_emails`工具支持 Gmail 强大的搜索运算符：\n\n| 操作员 | 例子 | 描述 |\n| ---------------- | ------------------------- | -------------- |\n| `from:` | `from:john@example.com` | 来自特定发件人的电子邮件 |\n| `to:` | `to:mary@example.com` | 发送给特定收件人的电子邮件 |\n| `subject:` | `subject:\"meeting notes\"` | 主题中包含特定文本的电子邮件 |\n| `has:attachment` | `has:attachment` | 带附件的电子邮件 |\n| `after:` | `after:2024/01/01` | 某个日期之后收到的电子邮件 |\n| `before:` | `before:2024/02/01` | 某个日期之前收到的电子邮件 |\n| `is:` | `is:unread` | 具有特定状态的电子邮件 |\n| `label:` | `label:work` | 带有特定标签的电子邮件 |\n\n您可以组合多个运算符： `from:john@example.com after:2024/01/01 has:attachment`\n\n## 高级功能\n\n### 电子邮件内容提取\n\n服务器智能地从复杂的 MIME 结构中提取电子邮件内容：\n\n* 优先考虑纯文本内容（如有）\n* 如果纯文本不可用，则返回 HTML 内容\n* 处理具有嵌套部分的多部分 MIME 消息\n* 处理附件信息（文件名、类型、大小）\n* 保留原始电子邮件标题（发件人、收件人、主题、日期）\n\n### 国际角色支持\n\n服务器完全支持电子邮件主题和内容中的非 ASCII 字符，包括：\n\n* 土耳其语、中文、日语、韩语和其他非拉丁字母\n* 特殊字符和符号\n* 正确的编码确保在电子邮件客户端中正确显示\n\n### 全面的标签管理\n\n该服务器提供了一套完整的用于管理 Gmail 标签的工具：\n\n* **创建标签**：创建具有可自定义可见性设置的新标签\n* **更新标签**：重命名标签或更改其可见性设置\n* **删除标签**：删除用户创建的标签（系统标签受保护）\n* **查找或创建**：按名称获取标签，如果未找到则自动创建\n* **列出所有标签**：查看所有系统和用户标签的详细信息\n* **标签可见性选项**：控制标签在消息和标签列表中的显示方式\n\n标签可见性设置包括：\n\n* `messageListVisibility` ：控制标签是否出现在消息列表中（ `show`或`hide` ）\n* `labelListVisibility` ：控制标签在标签列表中的显示方式（ `labelShow` 、 `labelShowIfUnread`或`labelHide` ）\n\n这些标签管理功能可以直接通过 Claude 对电子邮件进行复杂的组织，而无需切换到 Gmail 界面。\n\n### 批量操作\n\n该服务器包括高效的批处理功能：\n\n* 一次处理最多 50 封电子邮件（可配置批量大小）\n* 自动对大型电子邮件集进行分块以避免 API 限制\n* 每个操作的详细成功/失败报告\n* 通过单独重试实现优雅的错误处理\n* 非常适合批量收件箱管理和组织任务\n\n## 安全说明\n\n* OAuth 凭据安全地存储在您的本地环境中（ `~/.gmail-mcp/` ）\n* 服务器使用离线访问来维持持久身份验证\n* 切勿共享或提交您的凭据以进行版本控制\n* 定期检查并撤销 Google 帐户设置中未使用的访问权限\n* 凭证存储在全局，但只有当前用户才能访问\n\n## 故障排除\n\n1. **未找到 OAuth 密钥**\n\n * 确保`gcp-oauth.keys.json`位于当前目录或`~/.gmail-mcp/`\n * 检查文件权限\n\n2. **凭证格式无效**\n\n * 确保您的 OAuth 密钥文件包含`web`或`installed`凭据\n * 对于 Web 应用程序，验证重定向 URI 是否配置正确\n\n3. **端口已被使用**\n\n * 如果端口 3000 已被使用，请在运行身份验证之前释放它\n * 您可以找到并停止使用该端口的进程\n\n4. **批量操作失败**\n\n * 如果批量操作失败，它们会自动重试单个项目\n * 检查具体失败的详细错误消息\n * 如果遇到速率限制，请考虑减少批次大小\n\n## 贡献\n\n欢迎贡献代码！欢迎提交 Pull 请求。\n\n## 运行评估\n\nevals 包会加载一个 mcp 客户端，然后运行 index.ts 文件，因此测试之间无需重新构建。您可以通过在 npx 命令前添加前缀来加载环境变量。完整文档可[在此处](https://www.mcpevals.io/docs)找到。\n\n```bash\nOPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts\n```\n\n## 执照\n\n麻省理工学院\n\n## 支持\n\n如果您遇到任何问题或有疑问，请在 GitHub 存储库上提交问题。","Chinese","zh-CN","githubUser","locale",{"_85":86,"_87":88,"_13":102,"_110":42,"_111":42,"_112":113,"_117":118,"_141":-5,"_16":142,"_143":144,"_145":146,"_33":43,"_164":131,"_165":166,"_170":-5,"_171":-5,"_172":-5,"_173":174,"_179":-5,"_153":127,"_180":181,"_185":-5,"_132":186,"_187":188},"addedAt","2024-12-26T08:29:50.587587825Z","argumentsJsonSchema",{"_89":90,"_99":100,"_94":101},"properties",{"_91":92,"_96":97},"GMAIL_OAUTH_PATH",{"_31":93,"_94":95},"Path to the OAuth keys JSON file for Gmail authentication.","type","string","GMAIL_CREDENTIALS_PATH",{"_31":98,"_94":95},"Path where Gmail OAuth credentials will be stored after authentication.","required",[91,96],"object",[103,104,105,106,107,108,109],"category:communication","category:app-automation","environment:network","hosting:local-only","language:javascript","license_grade:a","author:claimed","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":114,"_115":116},"# Gmail AutoAuth MCP Server\n\nA Model Context Protocol (MCP) server for Gmail integration in Claude Desktop with auto authentication support. This server enables AI assistants to manage Gmail through natural language interactions.\n\n![](https://badge.mcpx.dev?type=server 'MCP Server')\n[![smithery badge](https://smithery.ai/badge/@gongrzhe/server-gmail-autoauth-mcp)](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp)\n\n\n## Features\n\n- Send emails with subject, content, **attachments**, and recipients\n- **Full attachment support** - send and receive file attachments\n- **Download email attachments** to local filesystem\n- Support for HTML emails and multipart messages with both HTML and plain text versions\n- Full support for international characters in subject lines and email content\n- Read email messages by ID with advanced MIME structure handling\n- **Enhanced attachment display** showing filenames, types, sizes, and download IDs\n- Search emails with various criteria (subject, sender, date range)\n- **Comprehensive label management with ability to create, update, delete and list labels**\n- List all available Gmail labels (system and user-defined)\n- List emails in inbox, sent, or custom labels\n- Mark emails as read/unread\n- Move emails to different labels/folders\n- Delete emails\n- **Batch operations for efficiently processing multiple emails at once**\n- Full integration with Gmail API\n- Simple OAuth2 authentication flow with auto browser launch\n- Support for both Desktop and Web application credentials\n- Global credential storage for convenience\n\n## Installation & Authentication\n\n### Installing via Smithery\n\nTo install Gmail AutoAuth for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@gongrzhe/server-gmail-autoauth-mcp):\n\n```bash\nnpx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude\n```\n\n### Installing Manually\n1. Create a Google Cloud Project and obtain credentials:\n\n a. Create a Google Cloud Project:\n - Go to [Google Cloud Console](https://console.cloud.google.com/)\n - Create a new project or select an existing one\n - Enable the Gmail API for your project\n\n b. Create OAuth 2.0 Credentials:\n - Go to \"APIs & Services\" > \"Credentials\"\n - Click \"Create Credentials\" > \"OAuth client ID\"\n - Choose either \"Desktop app\" or \"Web application\" as application type\n - Give it a name and click \"Create\"\n - For Web application, add `http://localhost:3000/oauth2callback` to the authorized redirect URIs\n - Download the JSON file of your client's OAuth keys\n - Rename the key file to `gcp-oauth.keys.json`\n\n2. Run Authentication:\n\n You can authenticate in two ways:\n\n a. Global Authentication (Recommended):\n ```bash\n # First time: Place gcp-oauth.keys.json in your home directory's .gmail-mcp folder\n mkdir -p ~/.gmail-mcp\n mv gcp-oauth.keys.json ~/.gmail-mcp/\n\n # Run authentication from anywhere\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n b. Local Authentication:\n ```bash\n # Place gcp-oauth.keys.json in your current directory\n # The file will be automatically copied to global config\n npx @gongrzhe/server-gmail-autoauth-mcp auth\n ```\n\n The authentication process will:\n - Look for `gcp-oauth.keys.json` in the current directory or `~/.gmail-mcp/`\n - If found in current directory, copy it to `~/.gmail-mcp/`\n - Open your default browser for Google authentication\n - Save credentials as `~/.gmail-mcp/credentials.json`\n\n > **Note**: \n > - After successful authentication, credentials are stored globally in `~/.gmail-mcp/` and can be used from any directory\n > - Both Desktop app and Web application credentials are supported\n > - For Web application credentials, make sure to add `http://localhost:3000/oauth2callback` to your authorized redirect URIs\n\n3. Configure in Claude Desktop:\n\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n}\n```\n\n### Docker Support\n\nIf you prefer using Docker:\n\n1. Authentication:\n```bash\ndocker run -i --rm \\\n --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \\\n -v mcp-gmail:/gmail-server \\\n -e GMAIL_OAUTH_PATH=/gcp-oauth.keys.json \\\n -e \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\" \\\n -p 3000:3000 \\\n mcp/gmail auth\n```\n\n2. Usage:\n```json\n{\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"-v\",\n \"mcp-gmail:/gmail-server\",\n \"-e\",\n \"GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json\",\n \"mcp/gmail\"\n ]\n }\n }\n}\n```\n\n### Cloud Server Authentication\n\nFor cloud server environments (like n8n), you can specify a custom callback URL during authentication:\n\n```bash\nnpx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n```\n\n#### Setup Instructions for Cloud Environment\n\n1. **Configure Reverse Proxy:**\n - Set up your n8n container to expose a port for authentication\n - Configure a reverse proxy to forward traffic from your domain (e.g., `gmail.gongrzhe.com`) to this port\n\n2. **DNS Configuration:**\n - Add an A record in your DNS settings to resolve your domain to your cloud server's IP address\n\n3. **Google Cloud Platform Setup:**\n - In your Google Cloud Console, add your custom domain callback URL (e.g., `https://gmail.gongrzhe.com/oauth2callback`) to the authorized redirect URIs list\n\n4. **Run Authentication:**\n ```bash\n npx @gongrzhe/server-gmail-autoauth-mcp auth https://gmail.gongrzhe.com/oauth2callback\n ```\n\n5. **Configure in your application:**\n ```json\n {\n \"mcpServers\": {\n \"gmail\": {\n \"command\": \"npx\",\n \"args\": [\n \"@gongrzhe/server-gmail-autoauth-mcp\"\n ]\n }\n }\n }\n ```\n\nThis approach allows authentication flows to work properly in environments where localhost isn't accessible, such as containerized applications or cloud servers.\n\n## Available Tools\n\nThe server provides the following tools that can be used through Claude Desktop:\n\n### 1. Send Email (`send_email`)\n\nSends a new email immediately. Supports plain text, HTML, or multipart emails **with optional file attachments**.\n\nBasic Email:\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"cc\": [\"cc@example.com\"],\n \"bcc\": [\"bcc@example.com\"],\n \"mimeType\": \"text/plain\"\n}\n```\n\n**Email with Attachments:**\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Project Files\",\n \"body\": \"Hi,\\n\\nPlease find the project files attached.\\n\\nBest regards\",\n \"attachments\": [\n \"/path/to/document.pdf\",\n \"/path/to/spreadsheet.xlsx\",\n \"/path/to/presentation.pptx\"\n ]\n}\n```\n\nHTML Email Example:\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"mimeType\": \"text/html\",\n \"body\": \"

Meeting Reminder

Just a reminder about our meeting tomorrow at 10 AM.

Best regards

\"\n}\n```\n\nMultipart Email Example (HTML + Plain Text):\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Meeting Tomorrow\",\n \"mimeType\": \"multipart/alternative\",\n \"body\": \"Hi,\\n\\nJust a reminder about our meeting tomorrow at 10 AM.\\n\\nBest regards\",\n \"htmlBody\": \"

Meeting Reminder

Just a reminder about our meeting tomorrow at 10 AM.

Best regards

\"\n}\n```\n\n### 2. Draft Email (`draft_email`)\nCreates a draft email without sending it. **Also supports attachments**.\n\n```json\n{\n \"to\": [\"recipient@example.com\"],\n \"subject\": \"Draft Report\",\n \"body\": \"Here's the draft report for your review.\",\n \"cc\": [\"manager@example.com\"],\n \"attachments\": [\"/path/to/draft_report.docx\"]\n}\n```\n\n### 3. Read Email (`read_email`)\nRetrieves the content of a specific email by its ID. **Now shows enhanced attachment information**.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n**Enhanced Response includes attachment details:**\n```\nSubject: Project Files\nFrom: sender@example.com\nTo: recipient@example.com\nDate: Thu, 19 Jun 2025 10:30:00 -0400\n\nEmail body content here...\n\nAttachments (2):\n- document.pdf (application/pdf, 245 KB, ID: ANGjdJ9fkTs-i3GCQo5o97f_itG...)\n- spreadsheet.xlsx (application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, 89 KB, ID: BWHkeL8gkUt-j4HDRp6o98g_juI...)\n```\n\n### 4. **Download Attachment (`download_attachment`)**\n**NEW**: Downloads email attachments to your local filesystem.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\",\n \"attachmentId\": \"ANGjdJ9fkTs-i3GCQo5o97f_itG...\",\n \"savePath\": \"/path/to/downloads\",\n \"filename\": \"downloaded_document.pdf\"\n}\n```\n\nParameters:\n- `messageId`: The ID of the email containing the attachment\n- `attachmentId`: The attachment ID (shown in enhanced email display)\n- `savePath`: Directory to save the file (optional, defaults to current directory)\n- `filename`: Custom filename (optional, uses original filename if not provided)\n\n### 5. Search Emails (`search_emails`)\nSearches for emails using Gmail search syntax.\n\n```json\n{\n \"query\": \"from:sender@example.com after:2024/01/01 has:attachment\",\n \"maxResults\": 10\n}\n```\n\n### 6. Modify Email (`modify_email`)\nAdds or removes labels from emails (move to different folders, archive, etc.).\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\",\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"]\n}\n```\n\n### 7. Delete Email (`delete_email`)\nPermanently deletes an email.\n\n```json\n{\n \"messageId\": \"182ab45cd67ef\"\n}\n```\n\n### 8. List Email Labels (`list_email_labels`)\nRetrieves all available Gmail labels.\n\n```json\n{}\n```\n\n### 9. Create Label (`create_label`)\nCreates a new Gmail label.\n\n```json\n{\n \"name\": \"Important Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 10. Update Label (`update_label`)\nUpdates an existing Gmail label.\n\n```json\n{\n \"id\": \"Label_1234567890\",\n \"name\": \"Urgent Projects\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 11. Delete Label (`delete_label`)\nDeletes a Gmail label.\n\n```json\n{\n \"id\": \"Label_1234567890\"\n}\n```\n\n### 12. Get or Create Label (`get_or_create_label`)\nGets an existing label by name or creates it if it doesn't exist.\n\n```json\n{\n \"name\": \"Project XYZ\",\n \"messageListVisibility\": \"show\",\n \"labelListVisibility\": \"labelShow\"\n}\n```\n\n### 13. Batch Modify Emails (`batch_modify_emails`)\nModifies labels for multiple emails in efficient batches.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"addLabelIds\": [\"IMPORTANT\"],\n \"removeLabelIds\": [\"INBOX\"],\n \"batchSize\": 50\n}\n```\n\n### 14. Batch Delete Emails (`batch_delete_emails`)\nPermanently deletes multiple emails in efficient batches.\n\n```json\n{\n \"messageIds\": [\"182ab45cd67ef\", \"182ab45cd67eg\", \"182ab45cd67eh\"],\n \"batchSize\": 50\n}\n```\n\n## Advanced Search Syntax\n\nThe `search_emails` tool supports Gmail's powerful search operators:\n\n| Operator | Example | Description |\n|----------|---------|-------------|\n| `from:` | `from:john@example.com` | Emails from a specific sender |\n| `to:` | `to:mary@example.com` | Emails sent to a specific recipient |\n| `subject:` | `subject:\"meeting notes\"` | Emails with specific text in the subject |\n| `has:attachment` | `has:attachment` | Emails with attachments |\n| `after:` | `after:2024/01/01` | Emails received after a date |\n| `before:` | `before:2024/02/01` | Emails received before a date |\n| `is:` | `is:unread` | Emails with a specific state |\n| `label:` | `label:work` | Emails with a specific label |\n\nYou can combine multiple operators: `from:john@example.com after:2024/01/01 has:attachment`\n\n## Advanced Features\n\n### **Email Attachment Support**\n\nThe server provides comprehensive attachment functionality:\n\n- **Sending Attachments**: Include file paths in the `attachments` array when sending or drafting emails\n- **Attachment Detection**: Automatically detects MIME types and file sizes\n- **Download Capability**: Download any email attachment to your local filesystem\n- **Enhanced Display**: View detailed attachment information including filenames, types, sizes, and download IDs\n- **Multiple Formats**: Support for all common file types (documents, images, archives, etc.)\n- **RFC822 Compliance**: Uses Nodemailer for proper MIME message formatting\n\n**Supported File Types**: All standard file types including PDF, DOCX, XLSX, PPTX, images (PNG, JPG, GIF), archives (ZIP, RAR), and more.\n\n### Email Content Extraction\n\nThe server intelligently extracts email content from complex MIME structures:\n\n- Prioritizes plain text content when available\n- Falls back to HTML content if plain text is not available\n- Handles multi-part MIME messages with nested parts\n- **Processes attachments information (filename, type, size, download ID)**\n- Preserves original email headers (From, To, Subject, Date)\n\n### International Character Support\n\nThe server fully supports non-ASCII characters in email subjects and content, including:\n- Turkish, Chinese, Japanese, Korean, and other non-Latin alphabets\n- Special characters and symbols\n- Proper encoding ensures correct display in email clients\n\n### Comprehensive Label Management\n\nThe server provides a complete set of tools for managing Gmail labels:\n\n- **Create Labels**: Create new labels with customizable visibility settings\n- **Update Labels**: Rename labels or change their visibility settings\n- **Delete Labels**: Remove user-created labels (system labels are protected)\n- **Find or Create**: Get a label by name or automatically create it if not found\n- **List All Labels**: View all system and user labels with detailed information\n- **Label Visibility Options**: Control how labels appear in message and label lists\n\nLabel visibility settings include:\n- `messageListVisibility`: Controls whether the label appears in the message list (`show` or `hide`)\n- `labelListVisibility`: Controls how the label appears in the label list (`labelShow`, `labelShowIfUnread`, or `labelHide`)\n\nThese label management features enable sophisticated organization of emails directly through Claude, without needing to switch to the Gmail interface.\n\n### Batch Operations\n\nThe server includes efficient batch processing capabilities:\n\n- Process up to 50 emails at once (configurable batch size)\n- Automatic chunking of large email sets to avoid API limits\n- Detailed success/failure reporting for each operation\n- Graceful error handling with individual retries\n- Perfect for bulk inbox management and organization tasks\n\n## Security Notes\n\n- OAuth credentials are stored securely in your local environment (`~/.gmail-mcp/`)\n- The server uses offline access to maintain persistent authentication\n- Never share or commit your credentials to version control\n- Regularly review and revoke unused access in your Google Account settings\n- Credentials are stored globally but are only accessible by the current user\n- **Attachment files are processed locally and never stored permanently by the server**\n\n## Troubleshooting\n\n1. **OAuth Keys Not Found**\n - Make sure `gcp-oauth.keys.json` is in either your current directory or `~/.gmail-mcp/`\n - Check file permissions\n\n2. **Invalid Credentials Format**\n - Ensure your OAuth keys file contains either `web` or `installed` credentials\n - For web applications, verify the redirect URI is correctly configured\n\n3. **Port Already in Use**\n - If port 3000 is already in use, please free it up before running authentication\n - You can find and stop the process using that port\n\n4. **Batch Operation Failures**\n - If batch operations fail, they automatically retry individual items\n - Check the detailed error messages for specific failures\n - Consider reducing the batch size if you encounter rate limiting\n\n5. **Attachment Issues**\n - **File Not Found**: Ensure attachment file paths are correct and accessible\n - **Permission Errors**: Check that the server has read access to attachment files\n - **Size Limits**: Gmail has a 25MB attachment size limit per email\n - **Download Failures**: Verify you have write permissions to the download directory\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n\n## Running evals\n\nThe evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found [here](https://www.mcpevals.io/docs).\n\n```bash\nOPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts\n```\n\n## License\n\nMIT\n\n## Support\n\nIf you encounter any issues or have questions, please file an issue on the GitHub repository.\n","url","https://github.com/GongRzhe/Gmail-MCP-Server","githubRepository",{"_119":120,"_121":122,"_123":124,"_125":126,"_33":127,"_128":129,"_134":135,"_136":137,"_139":140},"defaultBranch","main","fullName","GongRzhe/Gmail-MCP-Server","githubTreeId",131401,"language","JavaScript","Gmail-MCP-Server","owner",{"_130":131,"_132":133},"login","GongRzhe","uid","nbxa24idzc","recentStargazers",23,"spdxLicense",{"_33":138},"MIT License","stargazers",414,"glamaJson",460,"inspectable",false,"integrations",[147,157],{"_148":149,"_31":155,"_132":156},"brand",{"_150":151,"_33":152,"_153":154},"logoSvgPath","M24 5.457v13.909c0 .904-.732 1.636-1.636 1.636h-3.819V11.73L12 16.64l-6.545-4.91v9.273H1.636A1.636 1.636 0 0 1 0 19.366V5.457c0-2.023 2.309-3.178 3.927-1.964L5.455 4.64 12 9.548l6.545-4.91 1.528-1.145C21.69 2.28 24 3.434 24 5.457z","Gmail","slug","gmail","Enables AI assistants to manage Gmail through natural language interactions, including sending emails, reading messages, searching emails, managing labels, and handling attachments via the Gmail API with OAuth2 authentication.","x0aq8dktho",{"_148":158,"_31":162,"_132":163},{"_150":159,"_33":160,"_153":161},"M12.19 2.38a9.344 9.344 0 0 0-9.234 6.893c.053-.02-.055.013 0 0-3.875 2.551-3.922 8.11-.247 10.941l.006-.007-.007.03a6.717 6.717 0 0 0 4.077 1.356h5.173l.03.03h5.192c6.687.053 9.376-8.605 3.835-12.35a9.365 9.365 0 0 0-2.821-4.552l-.043.043.006-.05A9.344 9.344 0 0 0 12.19 2.38zm-.358 4.146c1.244-.04 2.518.368 3.486 1.15a5.186 5.186 0 0 1 1.862 4.078v.518c3.53-.07 3.53 5.262 0 5.193h-5.193l-.008.009v-.04H6.785a2.59 2.59 0 0 1-1.067-.23h.001a2.597 2.597 0 1 1 3.437-3.437l3.013-3.012A6.747 6.747 0 0 0 8.11 8.24c.018-.01.04-.026.054-.023a5.186 5.186 0 0 1 3.67-1.69z","Google Cloud","google-cloud","Requires Google Cloud Project setup to obtain OAuth credentials for Gmail API access. Users must create a project in Google Cloud Console and enable the Gmail API.","vrmlcxjtpr","namespace","npmPackage",{"_33":167,"_168":169},"@gongrzhe/server-gmail-autoauth-mcp","weeklyDownloads",3632,"prompts","redditPostForeignId","resources","scores",{"_175":176,"_177":-5,"_178":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms",[182,183,184],"WINDOWS","LINUX","MACOS","tools","bq78z91y4a","updatedAt","2025-06-19T22:01:36.417417968Z","meta",[191,194,196,203,206,208,211,214,217,220,223,225,228,231,233,235,237,239,241],{"_192":193},"title","Gmail AutoAuth MCP Server | Glama",{"_195":42,"_33":31},"content",{"_197":198,"_199":200,"_201":202},"href","https://glama.ai/mcp/servers/@GongRzhe/Gmail-MCP-Server","rel","canonical","tagName","link",{"_195":43,"_204":205},"property","og:title",{"_195":42,"_204":207},"og:description",{"_195":209,"_204":210},"https://glama.ai/logo.png","og:logo",{"_195":212,"_204":213},"https://glama.ai/mcp/servers/@GongRzhe/Gmail-MCP-Server/og-image","og:image",{"_195":215,"_204":216},"630","og:image:height",{"_195":218,"_204":219},"1200","og:image:width",{"_195":221,"_204":222},"website","og:type",{"_195":198,"_204":224},"og:url",{"_195":226,"_204":227},"Glama – MCP Hosting Platform","og:site_name",{"_195":229,"_33":230},"summary_large_image","twitter:card",{"_195":226,"_33":232},"twitter:title",{"_195":42,"_33":234},"twitter:description",{"_195":212,"_33":236},"twitter:image",{"_195":215,"_33":238},"twitter:image:height",{"_195":218,"_33":240},"twitter:image:width",{"_242":243},"script:ld+json",{"_244":245,"_246":247},"@context","http://schema.org","@graph",[248],{"_244":249,"_250":251,"_252":253},"https://schema.org","@type","BreadcrumbList","itemListElement",[254,261,265,269],{"_250":255,"_256":257,"_33":258,"_259":260},"ListItem","item","https://glama.ai/","Glama","position",1,{"_250":255,"_256":262,"_33":263,"_259":264},"https://glama.ai/mcp","MCP",2,{"_250":255,"_256":266,"_33":267,"_259":268},"https://glama.ai/mcp/servers","Servers",3,{"_250":255,"_256":198,"_33":43,"_259":270},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_82":-5,"_29":274,"_189":293,"_328":-5},{"_85":86,"_87":275,"_13":280,"_110":42,"_111":42,"_112":281,"_117":282,"_141":-5,"_16":142,"_143":144,"_145":285,"_33":43,"_164":131,"_165":290,"_170":-5,"_171":-5,"_172":-5,"_173":291,"_179":-5,"_153":127,"_180":292,"_185":-5,"_132":186,"_187":188},{"_89":276,"_99":279,"_94":101},{"_91":277,"_96":278},{"_31":93,"_94":95},{"_31":98,"_94":95},[91,96],[103,104,105,106,107,108,109],{"_35":114,"_115":116},{"_119":120,"_121":122,"_123":124,"_125":126,"_33":127,"_128":283,"_134":135,"_136":284,"_139":140},{"_130":131,"_132":133},{"_33":138},[286,288],{"_148":287,"_31":155,"_132":156},{"_150":151,"_33":152,"_153":154},{"_148":289,"_31":162,"_132":163},{"_150":159,"_33":160,"_153":161},{"_33":167,"_168":169},{"_175":176,"_177":-5,"_178":-5},[182,183,184],[294,296,298,300,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316],{"_192":295},"Reviews | Gmail AutoAuth MCP Server | Glama",{"_195":297,"_33":31},"Read community reviews and feedback for Gmail AutoAuth MCP Server. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_197":299,"_199":200,"_201":202},"https://glama.ai/mcp/servers/@GongRzhe/Gmail-MCP-Server/reviews",{"_195":301,"_204":205},"Reviews | Gmail AutoAuth MCP Server",{"_195":297,"_204":207},{"_195":209,"_204":210},{"_195":212,"_204":213},{"_195":215,"_204":216},{"_195":218,"_204":219},{"_195":221,"_204":222},{"_195":299,"_204":224},{"_195":226,"_204":227},{"_195":229,"_33":230},{"_195":226,"_33":232},{"_195":297,"_33":234},{"_195":212,"_33":236},{"_195":215,"_33":238},{"_195":218,"_33":240},{"_242":317},{"_244":245,"_246":318},[319],{"_244":249,"_250":251,"_252":320},[321,322,323,324,325],{"_250":255,"_256":257,"_33":258,"_259":260},{"_250":255,"_256":262,"_33":263,"_259":264},{"_250":255,"_256":266,"_33":267,"_259":268},{"_250":255,"_256":198,"_33":43,"_259":270},{"_250":255,"_256":299,"_33":326,"_259":327},"Reviews",5,"review","actionData","errors"]

Rate & Review

MCP directory API