From e6f779637b8e2f78d0a3671723d0b4baffc01aa3 Mon Sep 17 00:00:00 2001
From: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
Date: Thu, 25 Jun 2026 10:29:11 +0800
Subject: [PATCH] Add Gmail MCP server

Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
Claude-Session: https://claude.ai/code/session_01S58U7phvDgphx6ZTXuWMJQ
---
 servers/shinzolabs.gmail-mcp-npx.json | 84 +++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 servers/shinzolabs.gmail-mcp-npx.json

diff --git a/servers/shinzolabs.gmail-mcp-npx.json b/servers/shinzolabs.gmail-mcp-npx.json
new file mode 100644
index 0000000..c453dca
--- /dev/null
+++ b/servers/shinzolabs.gmail-mcp-npx.json
@@ -0,0 +1,84 @@
+{
+  "$schema": "../schemas/server-definition.schema.json",
+  "id": "shinzolabs.gmail-mcp-npx",
+  "name": "Gmail (npx)",
+  "alias": "gmail",
+  "description": "Complete Gmail API access via MCP: send, read, search, and manage messages, threads, drafts, labels, filters, delegates, and settings (vacation responder, IMAP/POP, forwarding). Uses file-based Google OAuth2 with your own Google Cloud OAuth client.",
+  "logo": "https://avatars.githubusercontent.com/u/112792321?v=4",
+  "schema_version": "2.1",
+  "categories": [
+    "communication",
+    "productivity"
+  ],
+  "tags": [
+    "gmail",
+    "email",
+    "google",
+    "oauth",
+    "messaging",
+    "productivity"
+  ],
+  "transport": {
+    "type": "stdio",
+    "command": "npx",
+    "args": [
+      "-y",
+      "@shinzolabs/gmail-mcp"
+    ],
+    "env": {
+      "GMAIL_OAUTH_PATH": "${input:GMAIL_OAUTH_PATH}",
+      "GMAIL_CREDENTIALS_PATH": "${input:GMAIL_CREDENTIALS_PATH}"
+    },
+    "metadata": {
+      "inputs": [
+        {
+          "id": "GMAIL_OAUTH_PATH",
+          "label": "OAuth Keys File Path",
+          "description": "Path to your Google Cloud OAuth client keys file (gcp-oauth.keys.json). Create an OAuth 2.0 Client ID of type 'Desktop app' in Google Cloud Console with the Gmail API enabled, download the JSON, and point here. Leave blank to use the default ~/.gmail-mcp/gcp-oauth.keys.json.",
+          "type": "file_path",
+          "required": false,
+          "secret": false,
+          "placeholder": "~/.gmail-mcp/gcp-oauth.keys.json",
+          "obtain": {
+            "url": "https://console.cloud.google.com/apis/credentials",
+            "instructions": "1. Open Google Cloud Console > APIs & Services > Credentials\n2. Enable the Gmail API for your project\n3. Configure the OAuth consent screen (add yourself as a test user)\n4. Click 'Create Credentials' > 'OAuth client ID'\n5. Choose application type 'Desktop app'\n6. Download the JSON and save it (e.g. ~/.gmail-mcp/gcp-oauth.keys.json)\n7. Run 'npx @shinzolabs/gmail-mcp auth' once to authorize in the browser and generate the credentials/token file",
+            "button_label": "Open Google Cloud Console"
+          }
+        },
+        {
+          "id": "GMAIL_CREDENTIALS_PATH",
+          "label": "Credentials / Token File Path",
+          "description": "Path where the OAuth token (refresh token) is stored after authorizing. Generated by running 'npx @shinzolabs/gmail-mcp auth'. Leave blank to use the default ~/.gmail-mcp/credentials.json.",
+          "type": "file_path",
+          "required": false,
+          "secret": false,
+          "placeholder": "~/.gmail-mcp/credentials.json"
+        }
+      ]
+    }
+  },
+  "auth": {
+    "type": "oauth",
+    "instructions": "Bring your own Google OAuth client. In Google Cloud Console, enable the Gmail API and create an OAuth 2.0 Client ID of type 'Desktop app', then download the keys to gcp-oauth.keys.json. Run 'npx @shinzolabs/gmail-mcp auth' once to complete the browser consent flow; the resulting refresh token is saved to credentials.json. CLIENT_ID/CLIENT_SECRET/REFRESH_TOKEN env vars are only needed for remote/hosted deployments, not for local npx use."
+  },
+  "contributor": {
+    "name": "shinzo-labs",
+    "github": "shinzo-labs",
+    "url": "https://github.com/shinzo-labs/gmail-mcp"
+  },
+  "links": {
+    "repository": "https://github.com/shinzo-labs/gmail-mcp",
+    "homepage": "https://github.com/shinzo-labs/gmail-mcp#readme",
+    "documentation": "https://github.com/shinzo-labs/gmail-mcp#readme"
+  },
+  "platforms": [
+    "all"
+  ],
+  "capabilities": {
+    "tools": true,
+    "resources": false,
+    "prompts": false,
+    "read_only_mode": false
+  },
+  "changelog_url": "https://github.com/shinzo-labs/gmail-mcp/releases"
+}