/ الدليل / الملعب / mcp-google-sheets
← كل الخوادم ↗ GitHub
● مجتمع xing5 ⚡ فوري

mcp-google-sheets

بواسطة xing5 · xing5/mcp-google-sheets

أعط Claude إمكانية القراءة والكتابة إلى Google Sheets — 19 أداة تغطي الخلايا والصفوف والأوراق والرسوم البيانية والصيغ والبحث عبر الأوراق

mcp-google-sheets يغلف APIs من Sheets و Drive إلى حوالي 19 أداة MCP. يغطي إنشاء جداول البيانات والتحديثات الدفعية للخلايا وإضافة الرسوم البيانية والبحث عبر عدة ملفات والمشاركة. المصادقة عبر حساب خدمة Google (موصى به للعمليات بدون رأس) أو OAuth 2.0

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

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

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

عرض مباشر

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

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

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add google-sheets -- uvx mcp-google-sheets

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

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

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

إضافة مقاييس يومية إلى ورقة Google من أي مصدر بيانات

👤 مهندسو العمليات / النمو ⏱ ~20 min intermediate

متى تستخدمه: تريد لوحة معلومات خفيفة في Sheets مغذاة بأي شيء يمكن للوكيل الوصول إليه (Sentry و Stripe و قاعدة بيانات)

المتطلبات الأساسية
  • حساب خدمة Google مع تفعيل Sheets + Drive API — console.cloud.google.com → إنشاء SA → تنزيل JSON → تعيين SERVICE_ACCOUNT_PATH
  • ورقة مشاركة مع بريد SA — واجهة Sheets → المشاركة → إضافة [email protected] كمحرر
الخطوات
  1. تحديد ورقة الهدف
    استخدم mcp-google-sheets للعثور على جدول البيانات بعنوان 'Daily KPIs'. أرجع معرّفها✓ تم النسخ
    → معرّف جدول البيانات
  2. إضافة صف اليوم
    أضف صفًا إلى ورقة 'summary' بأعمدة [date, signups, mrr, errors]. استخدم قيم اليوم من [مصدرك]✓ تم النسخ
    → add_rows يؤكد إضافة الصف في الأسفل
  3. تحديث رسم بياني إذا لزم الأمر
    تحقق من أن رسم البياني ذو 30 يومًا الأخيرة قد التقط الصف الجديد؛ إن لم يحدث، قم بتحديثه✓ تم النسخ
    → يظهر الرسم البياني بيانات اليوم

النتيجة: لوحة معلومات مباشرة في Sheets يتم تحديثها دون فتح الملف

المزالق
  • حد المعدل (429) بعد العديد من تحديثات الخلايا المفردة — استخدم batch_update_cells — استدعاء واحد يمكن أن يعدل مئات الخلايا
  • حساب الخدمة لا يرى الورقة — يجب عليك مشاركة الورقة صراحة مع بريده — SA ليس لديه إمكانية وصول ضمنية
اجمعها مع: sentry · postgres

إزالة المدخلات المكررة عبر جداول Google متعددة

👤 عمليات البيانات وأدمن CRM ⏱ ~25 min intermediate

متى تستخدمه: يحتفظ أعضاء الفريق بجداول منفصلة وتحتاج إلى قائمة موحدة نظيفة واحدة

الخطوات
  1. تعداد ورقات المصدر
    اسرد جميع جداول البيانات في مجلد 'Leads 2026' Drive الخاص بي باستخدام list_spreadsheets✓ تم النسخ
    → قائمة من 5-20 جدول
  2. سحب جميع الصفوف إلى الذاكرة
    استخدم get_multiple_sheet_data لسحب علامة التبويب 'Leads' من كل واحد. دمج حسب البريد الإلكتروني✓ تم النسخ
    → مجموعة بيانات مدمجة مع عدد التكرار
  3. كتابة ورقة موحدة
    أنشئ جدول بيانات جديد 'Leads 2026 - Consolidated' مع صفوف مزالة التكرار مرتبة حسب آخر لمس✓ تم النسخ
    → ورقة مقصد نظيفة

النتيجة: ورقة واحدة قانونية؛ الأصول لم تُمس للتدقيق

إنشاء تقرير Sheets بالصيغ وليس القيم المجمدة

👤 محللو المالية ⏱ ~30 min advanced

متى تستخدمه: تريد أن تعيد حساب الورقة عند تحديث علامات التبويب المصدر

الخطوات
  1. إنشاء الشكل
    أنشئ ورقة 'Q1 Report' بعلامات تبويب [summary, by_region, by_product]✓ تم النسخ
    → ورقة + علامات تبويب تم إنشاؤها
  2. حقن الصيغ التي تشير إلى المصدر
    في summary!B2، اكتب =SUMIFS('source'!C:C, 'source'!A:A, ">=2026-01-01"). استخدم batch_update بقيم الصيغ✓ تم النسخ
    → خلايا الحوسبة المباشرة

النتيجة: تقرير ذاتي التحديث — غير بيانات المصدر والأرقام تتغير

استيراد CSV وإثراء كل صف بأعمدة تم إنشاؤها بواسطة AI

👤 الموسيقيون وأوبس المبيعات ⏱ ~30 min intermediate

متى تستخدمه: لديك قائمة من URLs/الشركات وتريد وصفًا تم إنشاؤه بواسطة AI أو تصنيفات لكل صف

الخطوات
  1. استيراد CSV
    أنشئ جدول بيانات من هذا CSV: [الصق]. سميها 'Leads Enriched'✓ تم النسخ
    → ورقة بـ N صفوف
  2. إضافة وملء الأعمدة المشتقة
    أضف أعمدة 'industry' و 'one_line_pitch'. لكل صف، استخرجها من url/الشركة واكتب مرة أخرى عبر batch_update_cells✓ تم النسخ
    → عمودان جديدان مملوءان

النتيجة: قائمة غنية جاهزة للتواصل

اجمعها مع: firecrawl

التركيبات

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

google-sheets + sentry

نسبة عدم التعطل اليومية من Sentry مسجلة إلى ورقة KPI

كل يوم، اسحب نسبة جلسة عدم التعطل من Sentry وأضف صفًا إلى ورقة 'Daily KPIs'✓ تم النسخ
google-sheets + firecrawl

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

قم بتشغيل firecrawl_extract على صفحات التسعير للمنافسين الخمسة هذه واكتب كل خطة كصف في 'Competitor Pricing'✓ تم النسخ
google-sheets + postgres

تصدير استعلام DB يومي إلى Sheets لزملائك غير التقنيين

SELECT * FROM signups WHERE day = CURRENT_DATE; write to tab 'Signups' in my ops sheet.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_spreadsheets folder_id? اكتشف الأوراق في مجلد 1 Drive API call
create_spreadsheet title: str, sheets?: str[] وثيقة جديدة 1 API call
get_sheet_data spreadsheetId, sheet, range? اقرأ نطاقًا 1 API call
update_cells spreadsheetId, range, values الكتابات الصغيرة 1 API call
batch_update_cells spreadsheetId, updates أي كتابة >10 خلايا — تجنب حدود المعدل 1 API call
add_rows spreadsheetId, sheet, rows إضافة فقط مثل السجل 1 API call
add_chart spreadsheetId, sheet, chart_spec تصور نطاقًا 1 API call
share_spreadsheet spreadsheetId, email, role منح إمكانية وصول التعاون 1 Drive call
search_spreadsheets query: str البحث عن قيمة عبر عدة ملفات N API calls

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

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

حصة API
Sheets API: 300 قراءة + 300 طلب كتابة/دقيقة/مشروع، 60/مستخدم. Drive API: 1k طلب/100s/مستخدم
الرموز لكل استدعاء
100–5000 اعتمادًا على حجم النطاق
التكلفة المالية
مجاني ضمن حصص Google الافتراضية
نصيحة
دفعات الكتابة بقوة — batch_update_cells استدعاء API واحد بغض النظر عن عدد الخلايا

الأمان

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

الحد الأدنى من الصلاحيات: https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.file
تخزين بيانات الاعتماد: Service account JSON في SERVICE_ACCOUNT_PATH، أو OAuth tokens في TOKEN_PATH
نقل البيانات الخارجي: sheets.googleapis.com, drive.googleapis.com
لا تمنح أبدًا: https://www.googleapis.com/auth/drive (full)

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

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

403 The caller does not have permission

مشاركة الورقة مع بريد حساب الخدمة (client_email في JSON)

تحقق: افتح الورقة → المشاركة → تأكد من أن SA مدرجة
429 Quota exceeded

استخدم batch_update بدلاً من العديد من التحديثات الفردية؛ حد Sheets API هو في الدقيقة

Invalid range A1 notation

النطاق يحتاج إلى اسم الورقة: 'Sheet1!A1:C10'، وليس 'A1:C10'

gcloud auth works but mcp doesn't

اضبط SERVICE_ACCOUNT_PATH بوضوح لتجنب الغموض

تحقق: echo $SERVICE_ACCOUNT_PATH

البدائل

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

البديلمتى تستخدمهاالمقايضة
Zapier MCPتدفع بالفعل مقابل Zapier وتريد التوجيه بدون كودتسعير لكل مهمة؛ تحكم أقل مباشرة
Notion MCP (databases)تفضل واجهة قاعدة بيانات Notion ولا تحتاج إلى صيغلا محرك صيغ

المزيد

الموارد

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

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

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