מדריך · Google Workspace CLI + קלוד קוד

Google Workspace CLI: מחברים את קלוד קוד לג'ימייל, ליומן ולדרייב

Google Workspace CLI (הפקודה gws) הוא כלי קוד פתוח שנותן לקלוד קוד לעבוד בתוך ג'ימייל, דרייב, יומן גוגל, שיטס ודוקס, ולפי ה-README הוא מגיע עם יותר מ-40 סקילים מוכנים. מתקינים אותו בפקודת npm אחת ומתחברים פעם אחת דרך פרויקט ב-Google Cloud. חשוב לדעת: זה לא מוצר רשמי של גוגל.

מאת פלג דרור · פורסם ב- · 9 דקות קריאה

מה זה Google Workspace CLI?

אתם מכירים את הימים שבהם חצי מהעבודה זה לקפוץ בין ג'ימייל, היומן והדרייב? לענות ללקוח, לקבוע פגישה, למצוא את הקובץ ששלחו לכם לפני שבוע ולהעתיק מספרים לשיטס. Google Workspace CLI נותן לקלוד קוד לעשות את המעברים האלה בשבילכם, ואתם רק כותבים לו מה צריך.

Google Workspace CLI הוא כלי שעובד מהטרמינל, והפקודה שלו נקראת gws. הוא יושב בארגון googleworkspace בגיטהאב, כתוב בשפת Rust ומשוחרר ברישיון הקוד הפתוח Apache-2.0. הוא עלה לגיטהאב ב-2 במרץ 2026, ולפי npm הוא הורד 57,286 פעמים בשבוע שבין 6 ל-12 באוקטובר 2026.

הדבר שהכי מעניין בו: אין לו רשימה קבועה של פקודות. הוא קורא בזמן ריצה את שירות ה-Discovery של גוגל ובונה ממנו את הפקודות, אז כשגוגל מוסיפה אפשרות חדשה ל-API, הכלי מכיר אותה לבד. כל תשובה חוזרת כ-JSON מובנה, וזה בדיוק הפורמט שסוכן כמו קלוד קוד קורא הכי טוב.

בשביל הסוכנים יש בפרויקט גם סקילים מוכנים. בראש ה-README כתוב שיש יותר מ-40, ובתיקיית הסקילים בגיטהאב יש 95 נכון ל-15 באוקטובר 2026: 19 לשירותים עצמם, 25 קיצורים לפעולות נפוצות, 10 פרסונות ו-41 מתכונים לתרחישים כמו ניהול תיבת דואר או הכנה לפגישה.

ראש ה-README של gws בגיטהאב, עם השורה 40+ agent skills included וההערה שזה לא מוצר רשמי של גוגל
צילום מסך מתוך github.com/googleworkspace/cli: ראש ה-README, אוקטובר 2026

שימו לב לשורה בתמונה: This is not an officially supported Google product. הכלי יושב בגיטהאב של Google Workspace, אבל גוגל לא נותנת לו תמיכה רשמית.

מה צריך לפני שמתקינים את gws?

לפי ה-README יש שלושה דברים שצריך להכין מראש:

  • Node.js בגרסה 18 ומעלה, בשביל ההתקנה דרך npm. בלי Node אפשר להוריד קובץ מוכן מעמוד ה-Releases בגיטהאב.
  • פרויקט ב-Google Cloud. ההרשאות לג'ימייל ולדרייב עוברות דרכו (OAuth), אז בלעדיו אין התחברות.
  • חשבון גוגל. גם חשבון ג'ימייל פרטי עובד, וה-README מתייחס אליו במפורש באזהרה על כמות ההרשאות.

הפרויקט ב-Google Cloud נשמע כמו החלק המפחיד. תכלס זה צעד של פעם אחת, וקלוד קוד יכול להוביל אתכם בו צעד אחרי צעד, גם בלי להיות טכנולוגיים.

רשימת הדרישות מתוך ה-README של gws: Node.js 18 ומעלה, פרויקט ב-Google Cloud וחשבון גוגל
צילום מסך מתוך ה-README של googleworkspace/cli: הדרישות להתקנה, אוקטובר 2026

איך מתקינים את Google Workspace CLI?

שלב 1: מתקינים את gws

פותחים טרמינל ומריצים:

npm install -g @googleworkspace/cli

הפקודה מורידה בשבילכם מעמוד ה-Releases את הקובץ שמתאים למחשב שלכם. במק או בלינוקס עם Homebrew אפשר גם ככה: 

brew install googleworkspace-cli

בודקים שההתקנה עבדה:

gws --help

אם מופיעה רשימה של שירותים כמו drive, gmail ו-calendar, הכלי מותקן.

שלב 2: מתחברים לחשבון גוגל

יש לכם את gcloud, הכלי של Google Cloud, מותקן ומחובר? זאת הדרך הכי מהירה. הפקודה הראשונה רצה פעם אחת, יוצרת פרויקט, מפעילה את ה-API שצריך ומחברת אתכם. השנייה משמשת להתחברות בפעמים הבאות: 

gws auth setup
gws auth login

אין לכם gcloud? עושים את ההגדרה ידנית ב-Google Cloud Console, ככה כתוב ב-README:

  1. פותחים בפרויקט את מסך ההסכמה (OAuth consent screen) ובוחרים סוג External. מצב בדיקה (testing) מספיק.
  2. תחת Test users מוסיפים את הכתובת שלכם בג'ימייל. בלי זה ההתחברות נכשלת עם Access blocked.
  3. יוצרים OAuth client מסוג Desktop app.
  4. מורידים את קובץ ה-JSON ושומרים אותו בנתיב ~/.config/gws/client_secret.json.
  5. מריצים gws auth login.

באפליקציה במצב בדיקה גוגל מגבילה את ההסכמה לבערך 25 הרשאות. חבילת ההרשאות המומלצת (recommended) כוללת יותר מ-85, ולפי ה-README היא תיכשל, במיוחד בחשבון ג'ימייל פרטי. אז בוחרים רק את השירותים שאתם צריכים, כמו בפקודה שמתחת. 

gws auth login --scopes drive,gmail,calendar

בזמן ההתחברות כנראה תראו את המסך Google hasn't verified this app. זה צפוי באפליקציה במצב בדיקה: לוחצים Advanced, ואז על הקישור שממשיך לאפליקציה שלכם. לפי ה-README זה בטוח לשימוש אישי, ואימות של גוגל נדרש רק כשמפרסמים את האפליקציה למשתמשים אחרים.

שלב 3: נותנים לקלוד קוד להוביל

לא בא לכם לעבור על כל המסכים האלה לבד? פותחים את קלוד קוד וכותבים לו:

פרומפט לקלוד קוד

תעזור לי להגדיר את gws ולחבר את הג'ימייל, היומן והדרייב שלי.

הוא מריץ את הפקודות, אומר לכם על מה ללחוץ ב-Google Cloud Console, ועוצר כשצריך אתכם בדפדפן כדי לאשר את ההתחברות. ה-README אפילו מתאר מצב שבו הסוכן פותח את הקישור, בוחר חשבון ומאשר את ההרשאות בעצמו, כשיש לו כלי לשליטה בדפדפן.

שלב 4: מתקינים את הסקילים

הסקילים הם קבצי SKILL.md שמסבירים לסוכן איך לעבוד עם כל שירות (כתבתי על זה גם מדריך לסקילים בקלוד קוד). מתקינים את כולם בפקודה אחת: 

npx skills add https://github.com/googleworkspace/cli

או רק את מה שאתם צריכים, למשל דרייב וג'ימייל:

npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

ה-README לא מזכיר את קלוד קוד בשם. הוא מדבר על סוכני AI באופן כללי, ויש בו הוראות ל-Gemini CLI ול-OpenClaw. אבל gws הוא פקודה רגילה בטרמינל, וקלוד קוד מריץ אותה כמו כל פקודה אחרת, כך שהחיבור עובד גם אצלו.

עמוד הריפו googleworkspace/cli בגיטהאב, עם תיאור הכלי, ורישיון Apache-2.0
צילום מסך מתוך github.com/googleworkspace/cli: עמוד הריפו, אוקטובר 2026

מה אפשר לבקש מקלוד קוד אחרי החיבור?

מכאן מדברים איתו בעברית, כמו עם עוזר אישי, והוא מריץ מאחורי הקלעים את הפקודות של gws. הנה כמה בקשות שמתאימות לפקודות שקיימות בכלי:

ג'ימייל

תעבור על המיילים שלא קראתי מהיום ותגיד לי מה דחוף.

טיוטות תשובה

תקרא את המיילים מלקוחות מהיום ותכין טיוטת תשובה לכל אחד. אל תשלח כלום לפני שאני מאשר.

יומן

מה יש לי ביומן היום? ותקבע לי פגישה עם דנה ביום חמישי ב-10:00.

שיטס

תוסיף לגיליון ההכנסות שורה עם הלקוח החדש והסכום.

סיכום שבועי

תכין לי סיכום של הפגישות השבוע ותגיד לי כמה מיילים עוד לא קראתי.

לכל אחת מהבקשות האלה יש בכלי פקודה מוכנה. אלה החשובות מתוך טבלת הפקודות ב-README:

פקודה מה היא עושה
gws gmail +triage סיכום של המיילים שלא נקראו: שולח, נושא ותאריך
gws gmail +reply תשובה למייל, בתוך אותה שרשרת
gws gmail +send שליחת מייל חדש
gws calendar +agenda האירועים הקרובים ביומן, לפי אזור הזמן של החשבון
gws calendar +insert אירוע חדש ביומן
gws sheets +append שורה חדשה בגיליון
gws drive +upload העלאת קובץ לדרייב
gws workflow +meeting-prep הכנה לפגישה הבאה: אג'נדה, משתתפים ומסמכים מקושרים
gws workflow +weekly-digest הפגישות של השבוע וכמה מיילים לא נקראו
gws workflow +email-to-task הופך מייל למשימה ב-Google Tasks

הפקודות עם הפלוס הן קיצורים שהצוות כתב ידנית. חוץ מהן זמינה כל פעולה שקיימת ב-API של גוגל, למשל gws drive files list שמחזירה את רשימת הקבצים בדרייב, או יצירה של מצגת חדשה דרך הסקיל של Google Slides.

לפני שקלוד שולח משהו בשמכם, תבקשו לראות טיוטה. ל-gws יש גם דגל --dry-run שמראה מה הפקודה הולכת לעשות לפני שהיא עושה את זה.

אינדקס הסקילים של gws בגיטהאב, עם סקילים לדרייב, שיטס, ג'ימייל, יומן, דוקס, סליידס ושירותים נוספים
צילום מסך מתוך docs/skills.md בריפו googleworkspace/cli: הסקילים לפי שירות, אוקטובר 2026

אפשר להריץ את gws על שרת?

כן. לפי ה-README, הכלי עובד על המחשב שלכם, ב-CI ועל שרת. על שרת אין דפדפן, אז מתחברים פעם אחת במחשב רגיל, מייצאים את פרטי ההתחברות לקובץ ומעבירים אותו לשרת: 

gws auth export --unmasked > credentials.json

ובשרת מגדירים משתנה סביבה שמצביע על הקובץ:

export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/credentials.json

ככה סוכן שרץ על השרת יכול להריץ כל בוקר את gws workflow +standup-report ולהכין לכם את הפגישות והמשימות של היום. הקובץ הזה הוא מפתח לחשבון הגוגל שלכם, אז הוא לא עולה לגיטהאב, לא נשלח בצ'אט ולא יושב בתיקייה משותפת.

מה עושים כשההתחברות נכשלת?

אלה השגיאות שה-README מפרט בפרק התקלות, ומה עושים עם כל אחת:

השגיאה מה עושים
Access blocked או 403 מוסיפים את עצמכם תחת Test users במסך ההסכמה ומריצים שוב gws auth login
redirect_uri_mismatch ה-OAuth client לא נוצר מסוג Desktop app. מוחקים אותו, יוצרים חדש מהסוג הנכון ומורידים את ה-JSON מחדש
accessNotConfigured ה-API לא מופעל בפרויקט. נכנסים לקישור ש-gws מדפיס, לוחצים Enable, מחכים בערך 10 שניות ומנסים שוב
gcloud not found מתקינים את gcloud, או עושים את ההגדרה הידנית ב-Cloud Console
יותר מדי הרשאות בוחרים רק את השירותים שצריך עם --scopes

ואם נתקעתם, תדביקו את השגיאה לקלוד קוד. הוא מכיר את המסכים של Google Cloud ויגיד לכם איפה ללחוץ.

חשוב לדעת לפני שמתחילים

  • זה לא מוצר רשמי של גוגל. ה-README כותב את זה פעמיים, בהתחלה ובסוף. הכלי יושב בארגון googleworkspace בגיטהאב, אבל אין עליו תמיכה רשמית.
  • הכלי עדיין לפני גרסה 1.0. ה-README מזהיר שיהיו שינויים ששוברים דברים בדרך לשם. הגרסה האחרונה, v0.22.5, יצאה ב-31 במרץ 2026, ועד 15 באוקטובר 2026 לא יצאה גרסה חדשה.
  • הכלי חינמי, ההגדרה דורשת סבלנות. gws הוא קוד פתוח ואין עליו תשלום. החלק שלוקח זמן הוא הפרויקט ב-Google Cloud, ועושים אותו פעם אחת.
  • פרטי ההתחברות מוצפנים. לפי ה-README הם נשמרים מוצפנים (AES-256-GCM), והמפתח יושב ב-keyring של מערכת ההפעלה.
  • מיילים יכולים להכיל הוראות. סוכן שקורא את תיבת הדואר קורא גם מיילים של זרים, ומישהו יכול לנסות להחביא שם הוראות לסוכן. בשביל זה gws תומך ב-Model Armor של Google Cloud, שסורק את התשובות לפני שהן מגיעות לסוכן. ובכל מקרה, אל תתנו לקלוד לשלוח או למחוק בלי אישור שלכם.
  • מערכת הפעלה. npm עובד בכל מחשב עם Node.js 18 ומעלה, Homebrew עובד במק ובלינוקס, ובעמוד ה-Releases יש קבצים מוכנים למק, ללינוקס ולווינדוס (נכון לגרסה 0.22.5).

השורה התחתונה

אם היום שלכם עובר בג'ימייל, ביומן ובדרייב, gws נותן לקלוד קוד לעבוד שם יחד איתכם. ההגדרה דורשת קצת סבלנות פעם אחת, ומשם מבקשים בעברית.

שאלות נפוצות על Google Workspace CLI

האם Google Workspace CLI הוא כלי רשמי של גוגל?

לא. ה-README כותב במפורש שזה לא מוצר שגוגל תומכת בו רשמית. הקוד יושב בארגון googleworkspace בגיטהאב ומשוחרר ברישיון Apache-2.0, אבל אין עליו תמיכה רשמית של גוגל.

האם Google Workspace CLI חינמי?

הכלי עצמו הוא קוד פתוח וחינמי להתקנה. כדי להתחבר צריך חשבון גוגל ופרויקט ב-Google Cloud, שדרכו עוברות ההרשאות לג'ימייל, ליומן ולדרייב.

זה עובד עם קלוד קוד?

כן. gws הוא פקודה בטרמינל, וקלוד קוד מריץ אותה כמו כל פקודה אחרת. את הסקילים מתקינים עם npx skills add, וה-README מציג אותם כסקילים לכל סוכן AI.

קיבלתי Access blocked בהתחברות. מה עושים?

האפליקציה שלכם במצב בדיקה, והחשבון שלכם לא רשום בה כמשתמש בדיקה. נכנסים למסך ההסכמה בפרויקט ב-Google Cloud, מוסיפים את הכתובת שלכם תחת Test users ומריצים שוב gws auth login.

אפשר להריץ את gws על שרת?

כן. מתחברים פעם אחת במחשב עם דפדפן, מייצאים את פרטי ההתחברות עם gws auth export ומצביעים עליהם בשרת עם המשתנה GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE. את הקובץ הזה שומרים כמו סיסמה.

מה ההבדל בין gws לבין Composio?

Composio הוא שירות חיצוני שמחבר את קלוד קוד לג'ימייל ולגיליונות בלחיצה, ויש עליו מדריך נפרד באתר. gws מתחבר ישר ל-API של גוגל דרך פרויקט Google Cloud שלכם, ההגדרה ארוכה יותר, ופרטי ההתחברות נשמרים מוצפנים אצלכם במחשב.

עוד מדריכים לחיבור קלוד קוד לכלים שלכם