Claude Code مقامی شیل سے Google Workspace CLI (gws) کمانڈز چلا سکتا ہے۔ یہ gws میں تصدیق شدہ Google اکاؤنٹ استعمال کرتا ہے۔ مجاز اکاؤنٹ مالک Drive، Sheets، Docs اور Gmail میں ایک ایک غیر حساس ریکارڈ سے رابطہ جانچ سکتا ہے۔ پہلے اکاؤنٹ اور دی گئی اجازتیں یقینی بنائیں۔ یہ رہنما 20 اکتوبر 2026 کو دیکھی گئی CLI ریپوزٹری کے دستاویزی انٹرفیس پر مبنی ہے۔ BIG CHANGE نے دونوں میں سے کوئی ٹول نصب نہیں کیا اور کسی اکاؤنٹ تک رسائی نہیں لی۔

بڑی تبدیلی

  • کیا بدلا: موجودہ gws CLI، Google Workspace API کے طریقوں کو ایسی شیل کمانڈز کی شکل دیتا ہے جنہیں Claude Code چلا سکتا ہے۔ ایک تصدیق شدہ اکاؤنٹ کئی کام کی سروسز تک راستہ دے سکتا ہے، مگر حقیقی اجازتیں اور ایجنٹ کی شیل اجازتیں لاگو رہتی ہیں۔
  • یہ کیوں اہم ہے: جس رابطے سے ایجنٹ منتخب فائل یا پیغام دیکھ سکتا ہے، اسی سے OAuth کے دائرے میں آنے والا دوسرا ڈیٹا بھی قابل رسائی ہو سکتا ہے۔ مزید کام سونپنے سے پہلے مالک ٹرمینل اور Claude Code میں تھوڑے، پہلے سے معلوم نتائج کا موازنہ کر سکتا ہے۔
  • کن باتوں پر نظر رکھیں: سیٹ اپ بدلنے پر نصب شدہ CLI کی تیار کردہ کمانڈز اور سیشن میں نافذ اجازتوں کے اصول دیکھیں۔ CLI ابھی 1.0 سے پہلے کے مرحلے میں ہے؛ محدود مثالی استفسار یا فیلڈ ماسک پورے اکاؤنٹ کی اجازت کم نہیں کرتا۔

جوڑنے سے پہلے

الگ، منظور شدہ Google ٹیسٹ اکاؤنٹ استعمال کریں جس میں حساس مواد نہ ہو، اور ایسا Cloud پروجیکٹ لیں جہاں آپ OAuth ترتیب دے سکتے ہوں۔ منتظم سے پوچھیں کہ چاروں API اور مطلوب اجازتیں قابل قبول ہیں یا نہیں۔ منفرد نام کی موجودہ Drive فائل، چھوٹی حد میں معلوم قدروں والی اسپریڈشیٹ، ایک ٹیب والا مختصر عام متن کا Google Doc اور بے ضرر Gmail پیغام تیار کریں۔ Gmail کے لیے اس کا RFC Message-ID حاصل کریں Show original سے۔ ان اصل چیزوں کا موازنہ CLI نتائج سے ہوگا۔ یہ جانچیں کچھ بناتی یا بھیجتی نہیں۔

اپنے زیر کنٹرول کمپیوٹر پر Claude Code نصب کریں۔ gws نصب کریں اپنے OS کے لیے ریپوزٹری کی ریلیز سے یا Node.js 18 یا بعد کا ورژن ہو تو دستاویزی کمانڈ استعمال کریں:

Terminal
npm install -g @googleworkspace/cli
gws --version
gws --help
gws auth login --help

نصب CLI اور Claude Code کے ورژن نجی طور پر لکھیں۔ CLI ابھی 1.0 سے پہلے کا ہے اور اس کی کمانڈز Google کی API دریافت دستاویزات سے بنتی ہیں۔ مثالیں چلانے سے پہلے نصب مدد اور نیچے دیے طریقوں کے اسکیما دیکھیں۔

1. محدود OAuth لاگ ان ترتیب دیں

منظور شدہ Cloud پروجیکٹ میں Drive، Sheets، Docs اور Gmail API فعال کریں۔ OAuth سامعین ترتیب دیں اور Desktop app کلائنٹ بنائیں۔ ایپ External اور آزمائش میں ہو تو منتخب اکاؤنٹ کو ٹیسٹ صارف کے طور پر شامل کریں۔ ڈاؤن لوڈ کردہ کلائنٹ JSON کو دستاویز میں بتائی گئی ~/.config/gws/client_secret.json جگہ رکھیں یا GOOGLE_WORKSPACE_CLI_CONFIG_DIR سے منتخب الگ ڈائریکٹری لیں۔ اسے Claude پروجیکٹ سے باہر اور صرف اکاؤنٹ مالک کی دسترس میں رکھیں۔

لاگ ان سے پہلے نجی طور پر دیکھیں کہ GOOGLE_WORKSPACE_CLI_TOKEN یا GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE سیٹ تو نہیں، جس میں .env فائل کے ذریعے سیٹنگ بھی شامل ہے۔ ان ذرائع کو محفوظ OAuth اسناد پر ترجیح ملتی ہے۔ ان کی قدریں ظاہر نہ کریں اور Claude Code سے اسناد کی فائلیں پڑھنے کو نہ کہیں۔ صاف ماحول اور مطلوب کلائنٹ ترتیب استعمال کریں۔

یہ چار دائرے واضح طور پر طلب کریں:

Terminal
gws auth login --scopes 'https://www.googleapis.com/auth/drive.metadata.readonly,https://www.googleapis.com/auth/spreadsheets.readonly,https://www.googleapis.com/auth/documents.readonly,https://www.googleapis.com/auth/gmail.readonly'
gws auth status

اکاؤنٹ منتخب کرنا اور رضامندی دینا خود کریں۔ مقررہ ورژن کے CLI سورس میں openid، userinfo.email اور userinfo.profile شناختی دائرے بھی شامل ہوتے ہیں۔ نجی طور پر رضامندی اور gws auth status میں اکاؤنٹ، اجازتوں اور ٹوکن کی میعاد کو اپنی نیت سے ملائیں؛ غائب اسٹیٹس فیلڈ کی تصدیق نہیں ہوئی۔ اکاؤنٹ غلط ہو یا غیر متوقع وسیع اجازت باقی ہو تو رکیں۔ لاگ ان کے انتخاب میں سروسز چننا صرف متبادل چھانٹتا ہے؛ اس سے یہ چار صرف پڑھنے والے دائرے مقرر نہیں ہوتے۔

دائرے مثالی درخواستوں سے وسیع ہیں۔ Drive میٹاڈیٹا کی اجازت قابل رسائی فائلوں کے میٹاڈیٹا تک پہنچتی ہے؛ Sheets اور Docs کی صرف پڑھنے کی اجازت قابل رسائی اسپریڈشیٹس اور دستاویزات پر لاگو ہوتی ہے؛ Gmail کی صرف پڑھنے کی اجازت میل باکس کا مواد پڑھ سکتی ہے۔ نام، ID، حدود، استفسار اور فیلڈ ماسک ہر جواب محدود کرتے ہیں، ٹوکن کا اختیار نہیں۔ شیل ٹول مقامی اسناد تک بھی پہنچ سکتا ہے؛ چھپا فائل راستہ یا پرامپٹ کی ہدایت انہیں الگ نہیں کرتی۔

2. محدود پڑھنے کی کمانڈز براہ راست چلائیں

پہلے ہر طریقہ دیکھیں gws schema drive.files.list کے ذریعے اور دوسرے طریقوں کے متعلقہ اسکیما نام لیں۔ نصب ورژن میں پیرامیٹر مختلف ہو تو تیار شدہ --help مدد دیکھیں۔ نیچے کمانڈز Bash کے سنگل کوٹ نحو میں ہیں؛ دوسرے شیل کے لیے کوٹ احتیاط سے بدلیں۔ صرف ٹیسٹ شناخت کنندے اور نام بدلیں۔ ایک وقت میں ایک کمانڈ چلائیں اور حقیقی جواب یا خرابی نجی طور پر رکھیں، ٹوکن یا حساس مواد کے بغیر۔

نام کے مطابق Drive فائل تلاش کریں۔ JSON کا \u0027 Drive تلاش کے اظہار میں اپوسٹراف کو ایسکیپ کرتا ہے اور Bash کوٹ برقرار رکھتا ہے:

Terminal
gws drive files list --params '{"pageSize":5,"q":"trashed = false and name = \u0027GWS connection check\u0027","fields":"files(id,name,mimeType),nextPageToken,incompleteSearch"}'

واپس آنے والی ID اور نام Drive فائل سے ملائیں۔ مماثلت نہ ملنا یا incompleteSearch مطلوب فائل تک رسائی ثابت نہیں کرتا۔

حقیقی اسپریڈشیٹ ID اور ٹیب کے نام سے معلوم سیلز پڑھیں:

Terminal
gws sheets spreadsheets values get --params '{"spreadsheetId":"SPREADSHEET_ID","range":"Sheet1!A1:C3","fields":"range,majorDimension,values"}'

واپس آنے والی قدریں اسپریڈشیٹ سے ملائیں۔ Google آخر کے خالی سیلز چھوڑ سکتا ہے، اس لیے معلوم غیر خالی قدریں رکھیں۔

مختصر ٹیسٹ Doc کا پہلا ٹیب پڑھیں:

Terminal
gws docs documents get --params '{"documentId":"DOCUMENT_ID","includeTabsContent":false,"fields":"documentId,title,body(content(paragraph(elements(textRun(content)))))"}'

ID، عنوان اور معلوم متن ملائیں۔ یہ محدود جواب دوسرے ٹیب، تبصرے یا مکمل دستاویزی ساخت نہیں جانچتا۔

Gmail میں موجودہ پیغام کے RFC Message-ID سے تلاش کریں، پھر واپس آنے والی Gmail ID سے دو ہیڈر طلب کریں:

Terminal
gws gmail users messages list --params '{"userId":"me","maxResults":1,"q":"rfc822msgid:MESSAGE_ID_FROM_SHOW_ORIGINAL","fields":"messages(id,threadId),nextPageToken,resultSizeEstimate"}'
gws gmail users messages get --params '{"userId":"me","id":"GMAIL_MESSAGE_ID","format":"metadata","metadataHeaders":["Message-ID","Subject"],"fields":"id,threadId,payload(headers)"}'

واپس آنے والا Message-ID اور بے ضرر موضوع اصل پیغام سے ملائیں۔ پہلی کال پیغام کی ID دیتی ہے، ہیڈر نہیں۔ دوسری ہیڈر میٹاڈیٹا طلب کرتی ہے، پیغام کا متن نہیں۔ پہلا جواب خالی ہو تو دوسری جانچ نہیں ہو سکتی۔ Gmail کا تنگ میٹاڈیٹا OAuth دائرہ یہاں استعمال ہونے والے تلاش کے استفسار کی اجازت نہیں دیتا؛ واضح Gmail صرف پڑھنے کی اجازت دیتی ہے۔

3. اجازت کے پیغامات کے ساتھ Claude Code سے دہرائیں

اسی منظور شدہ اکاؤنٹ ترتیب سے اپنے زیر کنٹرول پروجیکٹ میں Claude Code شروع کریں۔ /permissions میں نافذ موڈ اور شیل اصول دیکھیں۔ Manual (جسے default بھی کہتے ہیں) اور حقیقی شیل ٹول کے لیے Ask اصول استعمال کریں؛ وسیع اجازت یا اصولوں سے گزرنے والی ترتیب تنظیم کی پالیسی کے مطابق حل کریں۔ gws * یا شیل ریپر کے لیے عمومی منظوری نہ دیں۔ ہر مجوزہ کمانڈ پوری دیکھیں اور صرف مطلوب محدود پڑھنے کی منظوری دیں۔

Claude Code کو عام زبان میں کہیں کہ انہی ٹیسٹ اہداف کے لیے اوپر کی پانچ کمانڈز تجویز کرے اور آپ کی اجازت کے فیصلے کے بعد ہی ایک ایک چلائے۔ اسناد پڑھے بغیر، استفسار بڑھائے بغیر یا لکھے بغیر آؤٹ پٹ یا خرابیاں بتائے۔ ہر نتیجہ براہ راست نتیجے اور اصل چیز دونوں سے ملائیں۔ پروجیکٹ ہدایات کام بیان کر سکتی ہیں، لیکن رسائی حقیقی ٹول اجازتوں اور OAuth اختیارات سے طے ہوتی ہے۔

سروس

دونوں راستوں سے تکمیل کا ثبوت

Drive

وہی فائل ID اور نام؛ تلاش مکمل ہو۔

Sheets

متوقع ٹیب، حد اور معلوم سیل قدریں۔

Docs

متوقع ID، عنوان اور پہلے ٹیب کا متن۔

Gmail

فہرست ٹیسٹ پیغام پاتی ہے؛ میٹاڈیٹا پڑھنے کا نتیجہ اس کے Message-ID اور موضوع سے ملتا ہے۔

ورژن، تصدیق شدہ اکاؤنٹ، حقیقی اجازتیں، ہدف ID، براہ راست نتیجہ، Claude نتیجہ اور خرابیاں نجی جانچ شیٹ میں لکھیں۔ ناکام درخواست، کامیاب مگر خالی جواب اور تصدیق شدہ چیز مختلف نتائج ہیں۔ چاروں سروسز دونوں راستوں سے ثابت ہونے پر ہی مکمل سمجھیں۔

جانچ ناکام ہو تو

لاگ ان پر Access blocked خرابی کا مطلب ہو سکتا ہے کہ ٹیسٹ اکاؤنٹ OAuth ایپ کے ٹیسٹ صارفین میں نہیں۔ API یا دائرے کی خرابی پر منظور شدہ دوبارہ رضامندی طلب کرنے سے پہلے فعال API، منتخب اکاؤنٹ اور حقیقی اجازتیں دیکھیں۔ خالی فہرست پر درست ہدف، استفسار اور اکاؤنٹ چیک کریں۔ نصب مدد مثالوں سے مختلف ہو تو پہلے موجودہ طریقے کا اسکیما لیں۔ Claude Code ڈیٹا بدلنے یا رسائی بڑھانے کی کمانڈ دے تو اجازت کے پیغام میں رد کریں اور محدود پڑھنے پر واپس آئیں۔

CLI ریپوزٹری کے لیے ادا شدہ پیکیج ضروری نہیں۔ اکاؤنٹ یا Workspace پلان، Cloud کوٹے اور Claude Code پلان یا API استعمال کی قیمت ہو سکتی ہے۔ حاصل مواد Claude Code میں مقرر فراہم کنندہ پراسیس کر سکتا ہے، اس لیے صرف منظور شدہ غیر حساس ٹیسٹ ڈیٹا لیں۔ CLI کہتا ہے کہ یہ Google کا سرکاری طور پر معاونت یافتہ پروڈکٹ نہیں اور 1.0 سے پہلے تبدیلیوں سے خبردار کرتا ہے۔ BIG CHANGE نے کارکردگی یا مطابقت نہیں آزمائی۔ کسی لکھنے، بھیجنے یا اکاؤنٹ بدلنے سے پہلے رکیں۔ Claude کا الگ Google Workspace ایڈ آن دوسرے راستے سے منظوری لے کر کھلی فائلوں میں ترمیم کا طریقہ بتاتا ہے۔