/ الدليل / الملعب / google-workspace-mcp
● مجتمع aaronsb ⚡ فوري

google-workspace-mcp

بواسطة aaronsb · aaronsb/google-workspace-mcp

Gmail + Calendar + Drive + إدارة حسابات متعددة في أداة MCP واحدة، مبنية على Google Workspace CLI الرسمية — 287 عملية عبر أكثر من 15 خدمة.

aaronsb/google-workspace-mcp تكشف عن 5 أدوات مجمعة (manage_email, manage_calendar, manage_drive, manage_accounts, queue_operations) تغطي معاً أكثر من 287 عملية عبر Google Workspace. مبنية على Google الرسمية gws CLI باستخدام مصنع موجه بـ manifest — إنها قريبة من الرسمية دون أن تكون من الطرف الأول.

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

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

عرض مباشر

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

google-workspace-2.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "google-workspace-2": {
      "command": "npx",
      "args": [
        "-y",
        "google-workspace-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "google-workspace-2": {
      "command": "npx",
      "args": [
        "-y",
        "google-workspace-mcp"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "google-workspace-2": {
      "command": "npx",
      "args": [
        "-y",
        "google-workspace-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "google-workspace-2": {
      "command": "npx",
      "args": [
        "-y",
        "google-workspace-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "google-workspace-2",
      "command": "npx",
      "args": [
        "-y",
        "google-workspace-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "google-workspace-2": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "google-workspace-mcp"
        ]
      }
    }
  }
}

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

claude mcp add google-workspace-2 -- npx -y google-workspace-mcp

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

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

استخدامات عملية: google-workspace-mcp

فرز بريدك الوارد وصياغة الردود

👤 أي شخص مثقل برسائل البريد الإلكتروني ⏱ ~15 min intermediate

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

المتطلبات الأساسية
  • عميل Google Cloud OAuth — console.cloud.google.com > Credentials
الخطوات
  1. المصادقة
    احمِ حسابي في Gmail عبر OAuth.✓ تم النسخ
    → اكتمال تدفق OAuth
  2. التصنيف
    استعرض رسائل البريد غير المقروءة من آخر 24 ساعة. صنفها إلى: رد عاجل، للعلم فقط، نشرة إخبارية، أشياء تشبه البريد المزعج. عد كل فئة.✓ تم النسخ
    → الأعداد + نماذج المواضيع لكل فئة
  3. صياغة الردود
    بالنسبة لفئة 'الرد العاجل'، اصغ ردود قصيرة (لا ترسلها). أريني المسودات للموافقة.✓ تم النسخ
    → المسودات جاهزة للمراجعة

النتيجة: 30 دقيقة من فرز البريد الوارد في 5.

المزالق
  • نموذج اللغة يختلق التزامات في المسودات — لا تدعه يرسل مباشرة — دائماً مسودة + مراجعة بشرية

ابحث عن فترة اجتماع تناسب 5 حاضرين

👤 أي شخص يجدول اجتماعات ⏱ ~5 min beginner

متى تستخدمه: تحتاج إلى 45 دقيقة في الأسبوع القادم تناسب 5 أشخاص عبر المناطق الزمنية.

الخطوات
  1. التحقق من التوفر
    ابحث عن فترة 45 دقيقة في الأسبوع القادم تناسبني وهؤلاء الـ 4 حاضرين [رسائل بريد]. استبعد ساعات الغداء في كل منطقة زمنية.✓ تم النسخ
    → الفترات المرشحة
  2. إنشاء حدث
    احجز أفضل فترة باسم 'المزامنة الأسبوعية' برابط Google Meet؛ ادع الجميع.✓ تم النسخ
    → تم إنشاء الحدث برابط فيديو

النتيجة: تم جدولة الاجتماع بدون رقصة Doodle.

المزالق
  • API الحر/المشغول يظهر فقط الحر/المشغول، وليس الأولويات — اسأل كل شخص قبل حجز الفترات الاختيارية بشكل نهائي

تدقيق صلاحيات مشاركة مجلد Drive

👤 العمليات / الامتثال ⏱ ~30 min intermediate

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

الخطوات
  1. التعداد
    اسرد جميع الملفات تحت /Shared drives/Contracts/2025 مع إعداداتها المشاركة. علّم أي شيء يحتوي على 'أي شخص يملك الرابط' أو 'عام'.✓ تم النسخ
    → قائمة الملفات مع علامات التعريض
  2. معالجة
    لكل ملف عام، غيّره إلى 'مقيد' وأخطر المالك. أريني الفرق قبل التنفيذ.✓ تم النسخ
    → خطة التغيير لكل ملف

النتيجة: تحسنت وضعية Drive في مرة واحدة.

المزالق
  • قد يؤدي الإلغاء إلى قطع سير العمل الخارجية النشطة — أخبر قبل الإلغاء؛ استخدم فترة استنزاف

التركيبات

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

google-workspace-2 + notion

مرآة مستندات Google إلى Notion أسبوعياً

لكل مستند تم إنشاؤه في /Shared/Team هذا الأسبوع، صدّره بصيغة Markdown وأنشئ صفحة Notion في 'Team Docs'.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
manage_email action: 'search'|'read'|'send'|'reply'|'label'|..., ... أي عملية Gmail 1 Gmail API call
manage_calendar action: 'list'|'create'|'update'|'delete'|'freebusy'|..., ... أي عملية تقويم 1 Calendar API call
manage_drive action: 'search'|'upload'|'download'|'share'|'export'|..., ... أي عملية Drive 1 Drive API call
manage_accounts action: 'add'|'remove'|'switch'|'list' التبديل بين حسابات متعددة free
queue_operations steps[] سلسلة العمليات التي تعتمد على بعضها البعض (مثل إنشاء مستند ومشاركته) sum of steps

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

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

حصة API
Gmail: 1B وحدة/يوم (معظم العمليات 5-50 وحدة). Calendar/Drive: حصص سخية.
الرموز لكل استدعاء
يمكن أن تكون نتائج قائمة Drive كبيرة — استخدم التقسيم إلى صفحات
التكلفة المالية
مجاني؛ مطلوب ترخيص Google Workspace للحسابات التجارية
نصيحة
احفظ بيانات الحساب في الذاكرة المؤقتة. بحث Gmail ثقيل على الحصة؛ حدد النطاق برموز التصفية والتاريخ.

الأمان

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

الحد الأدنى من الصلاحيات: Gmail.readonly + Calendar + Drive — امنح فقط ما تستخدمه
تخزين بيانات الاعتماد: الرموز في مفتاح بيانات نظام التشغيل (متوافق مع XDG)؛ يتم معالجة تحديث OAuth تلقائياً
نقل البيانات الخارجي: بيانات Google الخاصة بك تتدفق عبر MCP إلى مزود LLM الخاص بك
لا تمنح أبدًا: Gmail.modify لوكيل غير خاضع للإشراف يمكنه أيضاً قراءة عناوين URL خارجية

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

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

invalid_grant أثناء OAuth

عدم تطابق معرف العميل / redirect URI. تأكد من أن redirect URI المسجل في GCP يطابق ما يستخدمه MCP.

تم تجاوز الحصة

تراجع + دفعة. إرسال Gmail له حد يومي؛ Drive له حدود لكل مستخدم/ثانية.

تحقق: Google Cloud Console > APIs > Quotas
انتهت صلاحية الرموز رغم التحديث

تم إلغاء رمز التحديث — إعادة مصادقة. شائع عندما يتغير كلمة مرور الحساب أو يتم تشغيل حدث أمني.

البدائل

google-workspace-mcp مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Google Workspace MCP الرسمية (عند/إذا تم شحنها)Google تشحن MCP من الطرف الأولستكون أكثر سلطة؛ في الوقت الحالي هذا هو الخيار الأقوى من المجتمع
أدوات Google Workspace المستضافة من Zapier/Composioتريد مستضافة + بدون إعداد OAuthرسوم البرامج الوسيطة؛ سيطرة أقل

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills