/ الدليل / الملعب / google_workspace_mcp
← كل الخوادم ↗ GitHub
● مجتمع taylorwilsdon ⚡ فوري

google_workspace_mcp

بواسطة taylorwilsdon · taylorwilsdon/google_workspace_mcp

خادم MCP واحد لـ Gmail و Drive و Calendar و Docs و Sheets و Slides و Chat و Forms و Tasks و Contacts و Apps Script — مع تحميل أدوات متدرج للحفاظ على السياق صغيرًا.

taylorwilsdon/google_workspace_mcp هو MCP بـ Python يغلف واجهات برمجة تطبيقات Google Workspace خلف ~100 أداة. OAuth 2.0 عبر مشروع Google Cloud الخاص بك. اختر مستوى أداة (core / extended / complete) للتحكم في عدد الأدوات التي تظهر في عميل MCP الخاص بك.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

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

عرض مباشر

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

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

التثبيت

اختر العميل

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

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

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

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "google_workspace_mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "google_workspace_mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "google-workspace",
      "command": "uvx",
      "args": [
        "google_workspace_mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "google-workspace": {
      "command": {
        "path": "uvx",
        "args": [
          "google_workspace_mcp"
        ]
      }
    }
  }
}

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

claude mcp add google-workspace -- uvx google_workspace_mcp

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

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

استخدامات عملية: google_workspace_mcp

كيفية معالجة بريدك الوارد للوصول إلى الصفر باستخدام تسميات AI والمسودات

👤 العاملين في المعرفة والمديرين التنفيذيين ⏱ ~20 min intermediate

متى تستخدمه: صباح الاثنين أو بعد الإجازة عندما يكون بريدك الوارد ساحة حرب.

المتطلبات الأساسية
  • مشروع Google Cloud مع تفعيل Gmail API — console.cloud.google.com > APIs > Gmail API > تفعيل
  • بيانات اعتماد OAuth 2.0 Desktop — Credentials > Create OAuth client > Desktop. قم بتعيين متغيرات البيئة GOOGLE_OAUTH_CLIENT_ID و _SECRET
الخطوات
  1. سحب آخر أسبوع من الرسائل غير المقروءة
    ابحث في Gmail عن الرسائل غير المقروءة من آخر 7 أيام. قم بتجميعها حسب فئة المرسل (الفريق والخارجي والمورد والرسالة الإخبارية).✓ تم النسخ
    → تجميع الأعداد + سطور المعاينة
  2. تسمية تلقائية + أرشيف الرسائل الإخبارية
    بالنسبة لمجموعة الرسائل الإخبارية، قم بتسميتها 'newsletter' وأرشفتها.✓ تم النسخ
    → عدد الأرشيفات، معرفات الخيوط
  3. مسودة الردود على أفضل 5 خيوط حقيقية
    بالنسبة للخيوط الـ 5 الأكثر أهمية (طلب العميل والمانع والقرار المطلوب)، قم بصياغة رد موجز. لا تُرسل — فقط قم بالصياغة.✓ تم النسخ
    → 5 مسودات مرئية في Gmail

النتيجة: بريد وارد أقل من 20 رسالة، مسودات جاهزة للمراجعة والإرسال.

المزالق
  • تُرسل AI الردود بدلاً من الصياغة — قل دائمًا 'draft only' في الـ prompt؛ عطّل send_gmail_message للجلسات غير الموثوقة
اجمعها مع: notion

كيفية الاستعداد لكل اجتماع غد من تقويمك

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

متى تستخدمه: نهاية اليوم قبل يوم حافل.

الخطوات
  1. قائمة أحداث الغد
    احصل على أحداث تقويمي غدًا. لكل واحد، أظهر الحاضرين وعنوان الاجتماع.✓ تم النسخ
    → الجدول الزمني للأحداث
  2. لكل اجتماع، ابحث عن المستند المرتبط والرسائل الحديثة
    لكل اجتماع يحتوي على رابط جدول أعمال، افتح المستند وخلّص. لكل حاضر، أظهر آخر خيط بريد معهم.✓ تم النسخ
    → ملخص لكل اجتماع
  3. قم بإفراغ إلى مستند واحد
    أنشئ مستند 'Prep 2026-04-15' مع قسم لكل اجتماع.✓ تم النسخ
    → عنوان URL للمستند المرجعي

النتيجة: مستند تحضيري واحد يمكنك مسحه ضوئيًا أثناء شرب القهوة.

المزالق
  • رسائل الحاضرين الخارجيين تحتوي على معلومات التعريف الشخصية — تذهب إلى موفر LLM الخاص بك — قم بإزالة الأسماء فقط في الـ prompts إذا كنت تهتم
اجمعها مع: notion

كيفية تحويل جدول Google إلى مصدر بيانات قراءة/كتابة للوكلاء

👤 أشخاص العمليات الذين يقومون بتشغيل عمليات العمل على Sheets ⏱ ~15 min intermediate

متى تستخدمه: أنت لا تريد الهجرة إلى قاعدة بيانات حقيقية حتى الآن ولكنك تريد من AI أن تجيب على الأسئلة وتسجل الأحداث.

الخطوات
  1. وصف تخطيط الورقة
    اقرأ علامة التبويب 'Orders' في جدول البيانات 1AbC... — أخبرني بالمخطط.✓ تم النسخ
    → قائمة الأعمدة مع الأنواع
  2. الإجابة على سؤال
    باستخدام read_sheet_values، كم عدد الطلبات في مارس التي كانت أكثر من $1000؟✓ تم النسخ
    → إجابة رقمية + الخلايا المرجعية
  3. إضافة صف
    أضف صفًا جديدًا: تاريخ اليوم، customer=acme، amount=1200، status=pending.✓ تم النسخ
    → فهرس الصف المضاف

النتيجة: تحليلات موجزة + تسجيل بدون مغادرة الدردشة.

المزالق
  • تعيد الصيغ الحساب عند الكتابة وقد تستبدل الخلايا التي تهتم بها — استخدم append_table_rows، وليس كتابات النطاق، عند إضافة البيانات
اجمعها مع: filesystem

كيفية إنشاء مستند Google من نموذج markdown

👤 أي شخص ينشئ عروضًا أو تقارير أو مستندات نموذجية ⏱ ~10 min beginner

متى تستخدمه: تريد مخرجات Docs الغنية (الجداول والرؤوس) بدون تعلم واجهة برمجة تطبيقات Google.

الخطوات
  1. مسودة في markdown
    اكتب عرضًا للعميل لـ ACME بناءً على [brief]. الإخراج كـ markdown.✓ تم النسخ
    → مسودة Markdown
  2. تحويل إلى مستند
    أنشئ مستند Google جديد بعنوان 'ACME Proposal 2026-04' مع هذا المحتوى. استخدم create_doc ثم batch_update_doc للحفاظ على التنسيق.✓ تم النسخ
    → عنوان URL للمستند

النتيجة: مستند منسق بشكل صحيح يمكنك مشاركته.

المزالق
  • create_doc يقبل النص العادي فقط — التنسيق يحتاج إلى batch_update متابعة — استخدم دائمًا سير العمل ذي الخطوتين للمستندات الغنية

التركيبات

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

google-workspace + notion

عكس مستندات تحضير الاجتماع إلى Notion لرؤية الفريق

لكل اجتماع اليوم، انسخ جدول أعمال مستند Google إلى صفحة Notion جديدة ضمن 'Meeting Notes' مع التاريخ كعنوان.✓ تم النسخ
google-workspace + filesystem

تصدير مجلد Drive إلى القرص المحلي كنسخة احتياطية

قم بتنزيل كل ملف في مجلد Drive 'Client Contracts 2025' إلى /backups/drive/contracts-2025/.✓ تم النسخ
google-workspace + github

إجراء مراجع نصية لمشاكل GitHub مع standups التقويم

قبل standup الساعة 10 صباحًا، قم بإدراج مشاكل GitHub المفتوحة المعينة لي وأرفق الملخص بوصف حدث standup اليوم.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
search_gmail_messages query: str, max_results?: int البحث عن الرسائل حسب المرسل والموضوع والتاريخ 1 استدعاء Gmail API
draft_gmail_message to, subject, body, thread_id? الأفضلية للمسودة على الإرسال لسير عمل AI 1 استدعاء API
send_gmail_message to, subject, body فقط عندما يطلب المستخدم بوضوح الإرسال 1 استدعاء API (لا يمكن التراجع عنه)
get_events calendar_id?, time_min, time_max سحب الأحداث في نافذة زمنية 1 استدعاء Calendar API
manage_event action, event_id?, summary?, attendees?, time? إنشاء/تحديث/حذف الأحداث 1 استدعاء API
read_sheet_values spreadsheet_id, range قراءة نطاق خلايا 1 استدعاء Sheets API
append_table_rows spreadsheet_id, table_id, rows إضافة آمنة دون الكتابة فوق الصيغ 1 استدعاء Sheets API
create_doc title, content? ابدأ مستند جديد 1 استدعاء Docs API
batch_update_doc doc_id, requests[] تطبيق التنسيق بعد create_doc 1 استدعاء Docs API (معالج)
search_drive_files query, max_results? تحديد موقع ملف حسب الاسم/المالك 1 استدعاء Drive API

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

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

حصة API
Gmail: 250 وحدة حصة/مستخدم/ثانية. Sheets: 300 قراءة/دقيقة/مستخدم. Drive: 1000 استعلام/100 ثانية/مستخدم.
الرموز لكل استدعاء
قائمة الأدوات في مستوى 'complete' ضخمة جدًا (~100 أداة)؛ استخدم مستوى 'core' للبقاء برخص
التكلفة المالية
مجاني مع حساب Google
نصيحة
قم بالتشغيل مع --tool-tier core وانتقل إلى extended فقط عندما تحتاج بالفعل إلى Slides/Forms/Script.

الأمان

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

الحد الأدنى من الصلاحيات: منح الأذونات فقط للخدمات التي تستخدمها فعلاً (مثل gmail.readonly و calendar.readonly)
تخزين بيانات الاعتماد: GOOGLE_OAUTH_CLIENT_ID/_SECRET في متغيرات البيئة؛ الرموز المنعشة المثابرة على القرص
نقل البيانات الخارجي: محتوى مستنداتك/رسائلك ينتقل عبر خادم MCP إلى موفر LLM الذي اخترته
لا تمنح أبدًا: gmail.send إذا لم تكن بحاجة إلى الإرسال drive (full) إذا كان drive.file كافيًا admin scopes

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

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

invalid_grant / انتهت صلاحية الرمز أو تم إلغاؤه

احذف ملف الرمز المخزن مؤقتًا وأعد تشغيل سير المصادقة.

تحقق: ls ~/.config/google_workspace_mcp/tokens
403 أذونات غير كافية

أعد الموافقة بالنطاق المطلوب — لا يحتوي الرمز المخزن عليه بعد.

API not enabled

فعّل واجهة برمجة التطبيقات المحددة (مثل Docs API) في Google Cloud Console لمشروعك.

تم تجاوز الحصة للمستخدم

لـ Gmail و Sheets حدود لكل دقيقة. قراءات دفعية؛ تراجع مع إعادة محاولة أسية.

البدائل

google_workspace_mcp مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Gmail MCP الرسمي (Anthropic)تريد OAuth مضيفة بواسطة Anthropic بدون إعدادGmail فقط؛ بدون Drive/Docs/Sheets
zapier MCPأنت تدفع بالفعل لـ Zapier وتريد إعدادًا صفريًايكلف أموالاً لكل استدعاء؛ الكمون أعلى

المزيد

الموارد

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

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

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