Google Workspace MCP

لماذا تستخدمه

الميزات الأساسية

12 خدمة في خادم واحد: Gmail و Drive و Calendar و Docs و Sheets و Slides و Forms و Tasks و Contacts و Chat و Apps Script و Custom Search
مجموعة أدوات متدرجة (core / extended / complete) تُبقي قائمة الأدوات قابلة للإدارة
OAuth 2.0 + 2.1 مع وضع bearer-token متعدد المستخدمين للنشر المستضاف
وضع عديم الحالة لـ Docker / Kubernetes
تخزين رموز مميزة محلية مشفرة؛ وتخزين اعتمادات اختياري على GCS

عرض مباشر

كيف يبدو في الممارسة

google-workspace-mcp.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-workspace-mcp": {
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "google-workspace-mcp",
      "command": "uvx",
      "args": [
        "workspace-mcp",
        "--tool-tier",
        "core"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

{
  "context_servers": {
    "google-workspace-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "workspace-mcp",
          "--tool-tier",
          "core"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add google-workspace-mcp -- uvx workspace-mcp --tool-tier core

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Google Workspace MCP

فرز صندوق البريد الوارد في Gmail وصولاً إلى الصفر بمساعدة Claude

👤 أي شخص لديه أكثر من 200 رسالة غير مقروءة ⏱ ~25 min beginner

متى تستخدمه: صباح الاثنين وصندوق بريدك مكتظ بالرسائل.

المتطلبات الأساسية

عميل OAuth في Google Cloud — أنشئ بيانات اعتماد OAuth 2.0 في console.cloud.google.com، وحمّل client_secret.json
الخادم مثبّت — uvx workspace-mcp --tool-tier core (المكالمة الأولى تفتح المتصفح لـ OAuth)

الخطوات

تصنيف البريد الوارد

Use google-workspace-mcp. List unread mail from the last 7 days. Bucket into: action-required, FYI, newsletters, automated.✓ تم النسخ

→ أعداد لكل فئة مع نماذج عناوين رسائل
أرشفة الفئات منخفضة القيمة تلقائياً

Archive everything in newsletters + automated. Don't touch action-required.✓ تم النسخ

→ N رسالة مؤرشفة، 0 رسالة action-required متأثرة
صياغة الردود

For each action-required email, draft a 2-line reply in my voice. Save as drafts, don't send.✓ تم النسخ

→ مسودات ظاهرة في Gmail؛ تعدّلها وترسلها بنفسك

النتيجة: صندوق البريد يصل إلى أقل من 20 رسالة، والردود مسودات لم تُرسل بعد — المراجعة البشرية الكاملة بيدك.

المزالق

منحت نطاق Gmail الكامل وتندم على ذلك — استخدم --tool-tier core — لا يوجد أداة send_email حتى تختار extended

اجمعها مع: filesystem

إنشاء تقرير حالة أسبوعي من نشاط Calendar و Docs

👤 المطورون والمديرون الذين يكتبون تحديثات أسبوعية ⏱ ~10 min beginner

متى تستخدمه: بعد ظهر الجمعة ونسيت ما أنجزته هذا الأسبوع.

الخطوات

جلب التقويم

Use google-workspace-mcp. List meetings I attended Mon–Fri this week (skip declined). For each, give 1-line context.✓ تم النسخ

→ قائمة زمنية مع سياق موجز لكل اجتماع
جلب نشاط المستندات

List Drive docs I edited or commented on this week. Group by project.✓ تم النسخ

→ قائمة مستندات مجمّعة مع أعداد التعديلات والتعليقات
صياغة التحديث

Combine into a 6-bullet weekly update — what I shipped, what's blocked, what's next.✓ تم النسخ

→ مسودة جاهزة للإرسال عبر Slack أو البريد

النتيجة: تحديث أسبوعي استغرق 3 دقائق بدلاً من 30، مستند إلى مواد فعلية.

المزالق

التقويم ممتلئ باجتماعات متكررة تُعقّد التقرير — فلتر حسب أنماط عنوان الحدث أو عدد الحاضرين — اطلب من Claude تخطي الاجتماعات الفردية المتكررة افتراضياً

استخراج بيانات منظمة من Sheets المعقدة وكتابة النتائج فيها

👤 العمليات والمالية وكل من يعيش في جداول البيانات ⏱ ~20 min intermediate

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

الخطوات

قراءة النطاق

Use google-workspace-mcp. Read column B from Sheet 'Q4 expenses' — 1000 rows of vendor descriptions.✓ تم النسخ

→ الصفوف محملة؛ عينة معروضة
التصنيف

Categorize each row into: SaaS, hardware, travel, services, other. Show distribution first.✓ تم النسخ

→ جدول توزيع؛ أمثلة للمراجعة
الكتابة للخلف

Write categories into column F. Add a header. Don't touch other columns.✓ تم النسخ

→ الورقة محدّثة؛ تتحقق من عينة يدوياً

النتيجة: بيانات مصنفة في الورقة، وسجل مراجعة في المحادثة.

المزالق

Claude يكتب فوق عمود تهتم به — حدد العمود الهدف صراحةً دائماً؛ تحقق من بعض الخلايا قبل الكتابة الجماعية

إنشاء مستندات تحضير للاجتماعات تلقائياً من دعوات التقويم

👤 أي شخص لديه اجتماعات متتالية ⏱ ~15 min intermediate

متى تستخدمه: لديك 5 اجتماعات غداً وليس لديك أي سياق.

الخطوات

مسح اجتماعات الغد

Use google-workspace-mcp. List tomorrow's meetings with attendees and any attached docs.✓ تم النسخ

→ كتلة لكل اجتماع مع الحاضرين والمستندات المرتبطة
إنشاء الملخصات

For each, create a Doc 'Prep — <meeting title>' summarizing attached docs + suggesting 3 questions to ask.✓ تم النسخ

→ N مستندات أُنشئت في مجلد /Meeting prep/

النتيجة: ادخل كل اجتماع مستعداً، لا مرتجلاً.

المزالق

الحاضرون الخارجيون لا يرون مستند التحضير، لكن عنواناً مشتركاً قد يُفصح عن النية — استخدم مجلد تحضير خاصاً؛ عناوين مثل 'Prep — <موضوع>' لا '<اسم صفقة حساسة>'

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

google-workspace-mcp + filesystem

مزامنة مستندات Drive محلياً للتحرير دون اتصال أو تتبع git

Pull all docs in /weekly-updates/ from Drive into ./drive-mirror/ as markdown.✓ تم النسخ

google-workspace-mcp + github

مزامنة ملاحظات الإصدار بين GitHub ومستند Doc

Take the latest GitHub release notes and append them to the 'Release log' Google Doc.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
search_gmail	query: str (Gmail search syntax), max_results?	البحث عن رسائل تطابق معايير بلغة طبيعية	1 Gmail API call
send_email	to, subject, body, cc?, bcc?	متاح فقط في مستوى extended/complete — لا ترسل تلقائياً بدون تأكيد	1 API call
list_calendar_events	calendar_id, time_min, time_max	جلب الأحداث ضمن نطاق زمني	1 Calendar API call
read_sheet_range	spreadsheet_id, range (A1 notation)	جلب خلايا من ورقة بيانات	1 Sheets API call
write_sheet_values	spreadsheet_id, range, values[][]	تحديث نطاقات الورقة ببيانات محسوبة	1 API call
create_doc	title, content (markdown)	توليد مستندات جديدة من مخرجات المحادثة	1 Docs API call
search_drive	query, mime_type?	تحديد موقع الملفات بالاسم أو المحتوى	1 Drive API call

التكلفة والحدود

تكلفة التشغيل

حصة API: Gmail: 250 وحدة حصة/مستخدم/ثانية؛ Calendar: 500 طلب/100 ثانية؛ Sheets: 300 طلب/دقيقة/مستخدم
الرموز لكل استدعاء: 200–4000 حسب المكالمة (جسم البريد الكامل مقابل البيانات الوصفية)
التكلفة المالية: مجاني لحسابات Google الشخصية؛ منظمات Workspace قد تواجه قيوداً من المسؤول
نصيحة: استخدم --tool-tier core ما لم تحتج فعلاً لـ Forms/Slides/Apps-Script — عدد أدوات أقل = system prompt أصغر

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: gmail.readonly calendar.readonly drive.readonly

تخزين بيانات الاعتماد: تخزين رمز مميز محلي مشفر افتراضياً؛ اختياري على GCS للاستضافة

نقل البيانات الخارجي: مباشر إلى googleapis.com — لا وسيط طرف ثالث

لا تمنح أبدًا: gmail.send (حتى تفهم خطر الإرسال التلقائي) drive (قراءة/كتابة كاملة في كل مكان)

OAuth 2.0 + 2.1 مدعومان؛ اختر PKCE public client ما لم يكن لديك إعداد confidential client

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

فشل OAuth callback / المتصفح لا يفتح

اضبط OAUTH_REDIRECT_PORT على منفذ مفتوح وأعد التشغيل؛ على الأجهزة عديمة الرأس استخدم وضع device-flow

تحقق: lsof -i :8080 للتأكد من أن المنفذ حر

403 insufficient_permissions

أعد المصادقة بالنطاق المفقود؛ تحقق أن عميل OAuth يسمح به في Google Cloud Console

تحقق: فك تشفير الرمز على oauth2.googleapis.com/tokeninfo لرؤية النطاقات الممنوحة

مسؤول Workspace يحجب عميل OAuth

اطلب من المسؤول إضافة معرف عميلك إلى قائمة التطبيقات الموثوقة، أو استخدم حساباً شخصياً للاختبار

تجاوز الحصة في العمليات الجماعية

أضف تأخيراً تدريجياً؛ الخادم يحترم Retry-After headers لكن حلقات الجمع قد تعبر حدود الثواني

تحقق: ابحث عن HTTP 429 في السجلات

البدائل