English Français العربية

Gmail

السجل الرسمي البحث والويب

Gmail integration with OAuth authentication, message search, batch operations, and Sheets export

الموقع

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @mcp-z/mcp-gmail
Claude Code 
claude mcp add gmail -e 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' -e 'GOOGLE_CLIENT_SECRET=<your google_client_secret>' -e 'GOOGLE_SERVICE_ACCOUNT_KEY_FILE=<GOOGLE_SERVICE_ACCOUNT_KEY_FILE>' -e 'AUTH_MODE=<AUTH_MODE>' -e 'HEADLESS=false' -e 'REDIRECT_URI=<REDIRECT_URI>' -e 'RESOURCE_STORE_URI=<RESOURCE_STORE_URI>' -e 'PORT=<PORT>' -e 'BASE_URL=<BASE_URL>' -e 'LOG_LEVEL=<LOG_LEVEL>' -- npx -y @mcp-z/mcp-gmail@2.3.3 --auth --headless --redirect-uri --service-account-key-file --resource-store-uri --base-url --log-level
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "gmail": {
            "command": "npx",
            "args": [
                "-y",
                "@mcp-z/mcp-gmail@2.3.3",
                "--auth",
                "--headless",
                "--redirect-uri",
                "--service-account-key-file",
                "--resource-store-uri",
                "--base-url",
                "--log-level"
            ],
            "env": {
                "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
                "GOOGLE_CLIENT_SECRET": "<your google_client_secret>",
                "GOOGLE_SERVICE_ACCOUNT_KEY_FILE": "<GOOGLE_SERVICE_ACCOUNT_KEY_FILE>",
                "AUTH_MODE": "<AUTH_MODE>",
                "HEADLESS": "false",
                "REDIRECT_URI": "<REDIRECT_URI>",
                "RESOURCE_STORE_URI": "<RESOURCE_STORE_URI>",
                "PORT": "<PORT>",
                "BASE_URL": "<BASE_URL>",
                "LOG_LEVEL": "<LOG_LEVEL>"
            }
        }
    }
}

متغيرات البيئة

  • GOOGLE_CLIENT_ID إلزامي Google OAuth client ID (required for OAuth authentication modes)
  • GOOGLE_CLIENT_SECRET سري Google OAuth client secret (optional for public clients)
  • GOOGLE_SERVICE_ACCOUNT_KEY_FILE Path to service account JSON key file (required for service-account auth mode)
  • AUTH_MODE Authentication mode
  • HEADLESS Disable browser auto-open, return auth URL instead (true/false)
  • REDIRECT_URI OAuth redirect URI (optional, default: ephemeral loopback)
  • RESOURCE_STORE_URI Resource store URI for CSV export files (file://)
  • PORT HTTP server port (overrides --port)
  • BASE_URL Base URL for HTTP transport (used for OAuth/DCR endpoints and file links)
  • LOG_LEVEL Logging level
NPM package @mcp-z/mcp-gmail
Claude Code 
claude mcp add gmail -e 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' -e 'GOOGLE_CLIENT_SECRET=<your google_client_secret>' -e 'GOOGLE_SERVICE_ACCOUNT_KEY_FILE=<GOOGLE_SERVICE_ACCOUNT_KEY_FILE>' -e 'AUTH_MODE=<AUTH_MODE>' -e 'HEADLESS=false' -e 'REDIRECT_URI=<REDIRECT_URI>' -e 'DCR_MODE=self-hosted' -e 'DCR_VERIFY_URL=<DCR_VERIFY_URL>' -e 'DCR_STORE_URI=file://~/.mcp-z/mcp-gmail/dcr.json' -e 'RESOURCE_STORE_URI=<RESOURCE_STORE_URI>' -e 'PORT=<PORT>' -e 'BASE_URL=<BASE_URL>' -e 'LOG_LEVEL=<LOG_LEVEL>' -- npx -y @mcp-z/mcp-gmail@2.3.3 --port 9002 --auth --headless --redirect-uri --service-account-key-file --dcr-mode --dcr-verify-url --dcr-store-uri --resource-store-uri --base-url --log-level
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "gmail": {
            "command": "npx",
            "args": [
                "-y",
                "@mcp-z/mcp-gmail@2.3.3",
                "--port",
                "9002",
                "--auth",
                "--headless",
                "--redirect-uri",
                "--service-account-key-file",
                "--dcr-mode",
                "--dcr-verify-url",
                "--dcr-store-uri",
                "--resource-store-uri",
                "--base-url",
                "--log-level"
            ],
            "env": {
                "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
                "GOOGLE_CLIENT_SECRET": "<your google_client_secret>",
                "GOOGLE_SERVICE_ACCOUNT_KEY_FILE": "<GOOGLE_SERVICE_ACCOUNT_KEY_FILE>",
                "AUTH_MODE": "<AUTH_MODE>",
                "HEADLESS": "false",
                "REDIRECT_URI": "<REDIRECT_URI>",
                "DCR_MODE": "self-hosted",
                "DCR_VERIFY_URL": "<DCR_VERIFY_URL>",
                "DCR_STORE_URI": "file://~/.mcp-z/mcp-gmail/dcr.json",
                "RESOURCE_STORE_URI": "<RESOURCE_STORE_URI>",
                "PORT": "<PORT>",
                "BASE_URL": "<BASE_URL>",
                "LOG_LEVEL": "<LOG_LEVEL>"
            }
        }
    }
}

متغيرات البيئة

  • GOOGLE_CLIENT_ID إلزامي Google OAuth client ID (required for OAuth authentication modes)
  • GOOGLE_CLIENT_SECRET سري Google OAuth client secret (optional for public clients)
  • GOOGLE_SERVICE_ACCOUNT_KEY_FILE Path to service account JSON key file (required for service-account auth mode)
  • AUTH_MODE Authentication mode
  • HEADLESS Disable browser auto-open, return auth URL instead (true/false)
  • REDIRECT_URI OAuth redirect URI (optional, default: ephemeral loopback)
  • DCR_MODE Dynamic Client Registration mode
  • DCR_VERIFY_URL External verification endpoint URL (required for external DCR mode)
  • DCR_STORE_URI DCR client storage URI (for self-hosted DCR mode)
  • RESOURCE_STORE_URI Resource store URI for CSV export files (file://)
  • PORT HTTP server port (overrides --port)
  • BASE_URL Base URL for HTTP transport (used for OAuth/DCR endpoints and file links)
  • LOG_LEVEL Logging level

الأسئلة الشائعة

ما هو Gmail؟

Gmail integration with OAuth authentication, message search, batch operations, and Sheets export

كيف أثبّت Gmail؟

يعمل على جهازك. في Claude Code: claude mcp add gmail -e 'GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID>' -e 'GOOGLE_CLIENT_SECRET=<your google_client_secret>' -e 'GOOGLE_SERVICE_ACCOUNT_KEY_FILE=<GOOGLE_SERVICE_ACCOUNT_KEY_FILE>' -e 'AUTH_MODE=<AUTH_MODE>' -e 'HEADLESS=false' -e 'REDIRECT_URI=<REDIRECT_URI>' -e 'RESOURCE_STORE_URI=<RESOURCE_STORE_URI>' -e 'PORT=<PORT>' -e 'BASE_URL=<BASE_URL>' -e 'LOG_LEVEL=<LOG_LEVEL>' -- npx -y @mcp-z/mcp-gmail@2.3.3 --auth --headless --redirect-uri --service-account-key-file --resource-store-uri --base-url --log-level. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Gmail إلى مفتاح API؟

نعم. يتطلب GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET، وتضبطها في إعداداته.

من يصون Gmail؟

ينشره mcp-z. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.