שרת ה-MCP ליומן Google, רשימת הכלים החיה שלו נלכדה על Mac אמיתי.

• כלים

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

• אישורי גישה

  נדרש קובץ OAuth של Google [5]

• ערוץ תקשורת

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

• מתחזק

  nspady, פרויקט קהילתי [3][4]

• הורדות

  8.6 אלף בשבוע האחרון [2]

• רישיון

  MIT [3][1]

אימות

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

השיטה

הרצנו את השרת עם npx על גבי stdio, השלמנו את לחיצת היד של MCP וקראנו ל-tools/list. טבלת הכלים למטה היא התשובה הזו, מילה במילה, וגרסת הפרוטוקול למעלה נקראה ישירות מתשובת ה-initialize הגולמית. בלי קובץ אישורי גישה התהליך יוצא עוד לפני שהוא מדבר MCP בכלל, ולכן כיוונו את GOOGLE_OAUTH_CREDENTIALS לקובץ gcp-oauth.keys.json מזויף בעליל במקום ללקוח Google Cloud אמיתי: מספיק כדי להעלות את השרת ולספור מה שהוא מציע, לא מספיק כדי להגיע ל-Google. קריאת הכלי האחת שביצענו חזרה עם שגיאת האסימונים של השרת עצמו, המודפסת למטה. קריאה מאומתת עדיין ממתינה לאישורי גישה.

No token file found at: /tmp/mcp-verify-home/.config/google-calendar-mcp/tokens.json
⚠️  No authenticated accounts found.
Use the 'manage-accounts' tool with action 'add' to authenticate a Google account, or run:
  npx @cocal/google-calendar-mcp auth

tools/call list-calendars {}

MCP error -32600: Authentication tokens are no longer valid. Please restart the server to re-authenticate.

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

כלים

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

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

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

התקנה

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

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

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@cocal/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/Users/yourname/Documents/gcp-oauth.keys.json"
      }
    }
  }
}

claude mcp add --env GOOGLE_OAUTH_CREDENTIALS=/Users/yourname/Documents/gcp-oauth.keys.json --transport stdio google-calendar -- npx -y @cocal/google-calendar-mcp

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@cocal/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/Users/yourname/Documents/gcp-oauth.keys.json"
      }
    }
  }
}

Name        Google Calendar
Command     npx
Arguments   -y @cocal/google-calendar-mcp

Environment Variables
GOOGLE_OAUTH_CREDENTIALS    /Users/yourname/Documents/gcp-oauth.keys.json

בלי טרמינל

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

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

1. 01

   התקינו את Routines

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

2. 02

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

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

3. 03

   הורידו את קובץ המפתחות ושמרו אותו במקום קבוע

   Google מציעה את הלקוח החדש כהורדת קובץ JSON. שנו את שמו ל-gcp-oauth.keys.json ושמרו אותו במקום שלא יזוז, למשל בתיקיית Documents. הקובץ הזה מזהה את האפליקציה הקטנה שלכם מול Google; הוא לא היומן שלכם ולא סיסמה, אבל התייחסו אליו כאל קובץ פרטי בכל זאת.

4. 04

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

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

5. 05

   כוונו אותו לקובץ המפתחות, ואז בדקו

   ב-Environment Variables הוסיפו את GOOGLE_OAUTH_CREDENTIALS עם הנתיב המלא של הקובץ ששמרתם, למשל ‎/Users/yourname/Documents/gcp-oauth.keys.json. לחצו Test Connection: Routines מפעילה את השרת בלי לשמור אותו ומדווחת כמה כלים היא מצאה, שלושה עשר עבור השרת הזה. אחר כך לחצו Add Server.

6. 06

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

   השרת עולה בלי חיבור ל-Google ואומר זאת בעצמו. בצ׳אט, בקשו מהעוזר להשתמש בכלי manage-accounts עם הפעולה add. הוא פותח דף התחברות של Google בדפדפן, אתם מאשרים את הרשאות היומן, והאסימון שנוצר נשמר על ה-Mac שלכם. אחרי זה הכלים עובדים בצ׳אט מיד. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

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

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

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

פתרון תקלות

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

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

Failed to start server: Error loading OAuth keys: OAuth credentials not found. Please provide credentials using one of these methods:

1. Environment variable:
   Set GOOGLE_OAUTH_CREDENTIALS to the path of your credentials file:
   export GOOGLE_OAUTH_CREDENTIALS="/path/to/gcp-oauth.keys.json"

2. Default file path:
   Place your gcp-oauth.keys.json file in the package root directory.

Token storage:
- Tokens are saved to: /tmp/mcp-verify-home/.config/google-calendar-mcp/tokens.json
- To use a custom token location, set GOOGLE_CALENDAR_MCP_TOKEN_PATH environment variable

To get OAuth credentials:
1. Go to the Google Cloud Console (https://console.cloud.google.com/)
2. Create or select a project
3. Enable the Google Calendar API
4. Create OAuth 2.0 credentials
5. Download the credentials file as gcp-oauth.keys.json

Original error: ENOENT: no such file or directory, open '/tmp/mcp-verify-home/Documents/gcp-oauth.keys.json'

MCP error -32600: Authentication tokens are no longer valid. Please restart the server to re-authenticate.

MCP error -32602: Input validation error: Invalid arguments for tool list-events: Invalid input at calendarId

Error: Invalid tool name(s): not-a-real-tool-name. Available tools: list-calendars, list-events, search-events, get-event, list-colors, create-event, create-events, update-event, delete-event, get-freebusy, get-current-time, respond-to-event, manage-accounts

שאלות נפוצות

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

מקורות

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

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

1. [1]

   npm registry: @cocal/google-calendar-mcpנקרא בתאריך 2026-08-03

   Latest version 2.6.2, published 2026-06-01, MIT, repository nspady/google-calendar-mcp.

2. [2]

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

   8,606 downloads for the week ending 2026-08-01. The next calendar-specific package, @gongrzhe/server-calendar-autoauth-mcp, had 614.

3. [3]

   GitHub: nspady/google-calendar-mcpנקרא בתאריך 2026-08-03

   1,164 stars, MIT, not archived, last push 2026-06-01, per the GitHub API.

4. [4]

   nspady/google-calendar-mcp READMEנקרא בתאריך 2026-08-03

   Install and config for Claude Desktop, the tool table, the environment variables, the optional HTTP transport and the maintainer note.

5. [5]

   google-calendar-mcp docs: authenticationנקרא בתאריך 2026-08-03

   OAuth client setup, the gcp-oauth.keys.json shape, token storage paths, and the seven-day token expiry while the consent screen is in Testing mode.

6. [6]

   npm registry search: google-calendar-mcpנקרא בתאריך 2026-08-03

   The crowded namespace: an unscoped google-calendar-mcp by a different author, plus forks under @automate-army, @dongtran and @enterpret.

7. [7]

   GitHub: taylorwilsdon/google_workspace_mcpנקרא בתאריך 2026-08-03

   2,958 stars, MIT, not archived, last push 2026-08-02. Twelve Google Workspace services and 120 or more tools, in Python.

8. [8]

   PyPI: workspace-mcpנקרא בתאריך 2026-08-03

   Version 1.23.1. The Python and uvx run model, in contrast with npx here.

9. [9]

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

   The official Claude Desktop quickstart and the config file location.

10. [10]

    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.

11. [11]

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

    The mcp.json shape, including the env block, and the file locations.

12. [12]

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

    How Routines runs one-click OAuth connectors, Google Calendar among them, and any MCP server.

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