Add Gmail MCP server

Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
Claude-Session: https://claude.ai/code/session_01S58U7phvDgphx6ZTXuWMJQ

Author: its-mash

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"
+}