שרת ה-MCP ל-Google Drive, אומת בריצה חיה על Mac אמיתי.

• כלים

  4, נספרו בריצה חיה

• אישורי גישה

  נדרש לקוח OAuth של Google [4]

• ערוץ תקשורת

  stdio, רץ על ה-Mac שלכם [4]

• מתחזק

  isaacphi, עותק קהילתי [1][3]

• הורדות

  8,395 בשבוע האחרון [2]

• רישיון

  MIT [1][3]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

הרצנו את השרת עם npx על גבי stdio כשמוגדרים CLIENT_ID, CLIENT_SECRET ו-GDRIVE_CREDS_DIR, השלמנו את לחיצת היד של MCP וקראנו ל-tools/list: הוא ענה עם כל 4 הכלים, והטבלה למטה היא התשובה הזו, מילה במילה. גרסת הפרוטוקול למעלה נקראה ישירות מתשובת ה-initialize הגולמית, והיא ירדה מ-2025-06-18 שהצענו. שום חשבון Google אמיתי לא היה מעורב בשום שלב. תיקיית אישורי הגישה החזיקה אסימון דמה מובהק עם תאריך תפוגה רחוק, וזה מספיק לשרת כדי לטעון אותו בלי לשאול את Google דבר, וה-stderr שלו עצמו אומר זאת בבאנר למטה. אחר כך ביצענו קריאת כלי אמיתית אחת, gdrive_search עם השאילתה routines. היא יצאה ל-API של Drive של Google וחזרה עם השגיאה של Google עצמה, המודפסת למטה בדיוק כפי שהוחזרה: נסיעה אמיתית ברשת ולא כשל מקומי, וגם לא חיפוש מוצלח. הכלים אפוא נספרו בריצה חיה והשגיאה היא פלט אמיתי, בעוד שקריאה מאומתת עדיין ממתינה לאישורי גישה.

npm warn deprecated uuid@9.0.1: uuid@10 and below is no longer supported.  For ESM codebases, update to uuid@latest.  For CommonJS codebases, use uuid@11 (but be aware this version will likely be deprecated in 2028).
Setting up automatic token refresh interval (45 minutes)
Attempting to load credentials from: /tmp/mcp-verify-home-gdrive/gdrive-creds/.gdrive-server-credentials.json
Loaded existing credentials with scopes: https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/spreadsheets
Token expiry status: {
  expiryDate: '2030-01-01T00:00:00.000Z',
  timeToExpiryMinutes: 1794430,
  hasRefreshToken: true
}

tools/call gdrive_search {"query":"routines"}

{"code":401,"message":"Invalid Credentials"}

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 4 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

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

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@isaacphi/mcp-gdrive"],
      "env": {
        "CLIENT_ID": "<your-oauth-client-id>.apps.googleusercontent.com",
        "CLIENT_SECRET": "<your-oauth-client-secret>",
        "GDRIVE_CREDS_DIR": "/Users/yourname/Documents/mcp-gdrive"
      }
    }
  }
}

claude mcp add --env CLIENT_ID=<your-oauth-client-id>.apps.googleusercontent.com --env CLIENT_SECRET=<your-oauth-client-secret> --env GDRIVE_CREDS_DIR=/Users/yourname/Documents/mcp-gdrive --transport stdio gdrive -- npx -y @isaacphi/mcp-gdrive

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@isaacphi/mcp-gdrive"],
      "env": {
        "CLIENT_ID": "<your-oauth-client-id>.apps.googleusercontent.com",
        "CLIENT_SECRET": "<your-oauth-client-secret>",
        "GDRIVE_CREDS_DIR": "/Users/yourname/Documents/mcp-gdrive"
      }
    }
  }
}

Name        Google Drive
Command     npx
Arguments   -y @isaacphi/mcp-gdrive

Environment Variables
CLIENT_ID           <your-oauth-client-id>.apps.googleusercontent.com
CLIENT_SECRET       <your-oauth-client-secret>
GDRIVE_CREDS_DIR    /Users/yourname/Documents/mcp-gdrive

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ Google Drive בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים כמה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות. החלק המסובך הוא לא Routines אלא Google: לשרת הזה אין מפתח משותף להדביק, ולכן אתם יוצרים קודם לקוח OAuth משלכם. העקיפה הזו לוקחת בערך עשר דקות באתר של Google עצמה, ועושים אותה פעם אחת בלבד.

1. 01

   התקינו את Routines

   הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.

2. 02

   צרו לקוח OAuth ב-Google Cloud Console

   היכנסו ל-console.cloud.google.com, צרו פרויקט או בחרו אחד קיים, והפעילו עבורו גם את Google Drive API וגם את Google Sheets API, כי שניים מארבעת הכלים קוראים וכותבים ב-Sheets. פתחו את OAuth consent screen, בחרו External, והוסיפו את כתובת ה-Google שלכם תחת Test users, אחרת ההתחברות תידחה בהמשך. אחר כך פתחו את Credentials, לחצו על Create Credentials, בחרו OAuth client ID ובחרו בסוג Desktop app.

3. 03

   תנו לקובץ המפתחות תיקיה משלו

   Google מציעה את הלקוח החדש כהורדת קובץ JSON. צרו עבורו תיקיה, למשל ‎/Users/yourname/Documents/mcp-gdrive, ושמרו את הקובץ בתוכה בשם המדויק gcp-oauth.keys.json. בתיקיה הזו השרת גם יכתוב את האסימון שלכם אחרי ההתחברות, לכן בחרו מקום שלא יזוז, והשאירו אותה מחוץ לכל תיקיה משותפת או מסונכרנת.

4. 04

   הוסיפו את השרת ב-Routines

   לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server. העבירו את הטופס ל-Command (stdio): השרת הזה הוא פקודה, לא כתובת אינטרנט. Name: Google Drive. Command: npx. Arguments: ‎-y @isaacphi/mcp-gdrive, בדיוק שלוש המילים האלה.

5. 05

   מלאו את שלושת משתני הסביבה, ואז בדקו

   ב-Environment Variables הוסיפו את CLIENT_ID ואת CLIENT_SECRET, שניהם מועתקים מדף לקוח ה-OAuth ב-Google Cloud Console, ואת GDRIVE_CREDS_DIR עם הנתיב המלא של התיקיה שיצרתם, למשל ‎/Users/yourname/Documents/mcp-gdrive. לחצו Test Connection: Routines מפעילה את השרת בלי לשמור אותו ומדווחת כמה כלים היא מצאה, ארבעה עבור השרת הזה. אחר כך לחצו Add Server.

6. 06

   התחברו ל-Google פעם אחת, ואז השתמשו בו

   בהפעלה הראשונה שבה אין אסימון שמור, השרת פותח את דף ההתחברות של Google בדפדפן; אשרו את ההרשאות ל-Drive ול-Sheets, והאסימון נוחת בתיקיית אישורי הגישה שלכם בשם ‎.gdrive-server-credentials.json. עד שהקובץ הזה קיים, הכלים עדיין מופיעים ברשימה אבל כל קריאה חוזרת בסירוב, וזה בדיוק מה שהריצה שלנו לכדה. אחרי זה הכלים עובדים בצ׳אט מיד. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

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

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

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

{"code":401,"message":"Invalid Credentials"}

{"code":403,"message":"Method doesn't allow unregistered callers (callers without established identity). Please use API Key or other form of API consumer identity to call this API."}

SyntaxError: /private/tmp/mcp-verify-home-gdrive/bad-oauth-keys-dir/gcp-oauth.keys.json: Expected property name or '}' in JSON at position 2 (line 1 column 3)

{"code":-32603,"message":"Missing required parameters: fileId"}

{"code":-32603,"message":"Tool not found"}

Starting server

שאלות נפוצות

שאלות שאנשים שואלים.

מקורות

כל טענה חיצונית, עם קבלה.

כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.

1. [1]

   npm registry: @isaacphi/mcp-gdriveנקרא בתאריך 2026-08-03

   Latest version 0.2.0, published 2024-12-14, MIT, repository isaacphi/mcp-gdrive, sole npm maintainer isaacphi.

2. [2]

   npm downloads API: last weekנקרא בתאריך 2026-08-03

   8,395 downloads for the week ending 2026-08-02, against 6,046 for the archived @modelcontextprotocol/server-gdrive over the same week.

3. [3]

   GitHub: isaacphi/mcp-gdriveנקרא בתאריך 2026-08-03

   283 stars, MIT, not archived, last push 2025-05-07, per the GitHub API. The README credits the code it forked from as originally developed by Anthropic, PBC.

4. [4]

   npm package page: @isaacphi/mcp-gdriveנקרא בתאריך 2026-08-03

   The stdio config shape and the CLIENT_ID, CLIENT_SECRET and GDRIVE_CREDS_DIR environment variables, cross-checked against the shipped dist/auth.js, which reads exactly those three and hardcodes the two OAuth scopes the package requests, drive.readonly and spreadsheets.

5. [5]

   npm registry: @modelcontextprotocol/server-gdriveנקרא בתאריך 2026-08-03

   Latest version 2025.1.14, published 2025-01-14, carrying npm's deprecation notice: "Package no longer supported."

6. [6]

   GitHub: modelcontextprotocol/servers-archivedנקרא בתאריך 2026-08-03

   Archived true, 293 stars, described as "Reference MCP servers that are no longer maintained". Its README states no security guarantees are provided and to use at your own risk. Google Drive is listed there, at src/gdrive, and the current modelcontextprotocol/servers repository returns 404 for that path.

7. [7]

   modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03

   The official Claude Desktop quickstart, the config file location and the command, args and env block shape.

8. [8]

   Claude Code docs: MCPנקרא בתאריך 2026-08-03

   The claude mcp add syntax for local stdio servers, the --env flag, and the warning about placing the server name straight after --env.

9. [9]

   Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03

   The mcp.json shape, including the env block, and the global and per-project file locations.

10. [10]

    Routines: Connectorsנקרא בתאריך 2026-08-03

    How Routines runs one-click OAuth connectors and any MCP server, local stdio processes included, validating a new server by listing its tools.

העמוד הזה מתאר את Google Drive כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.