1. Перейдіть у Google Cloud Console через браузер;
2. Створіть новий проєкт із описовою назвою (наприклад, "gcalendar agent");
3. Перейдіть до щойно створеного проєкту після завершення ініціалізації.

0. Якщо буде запропоновано, натисніть "Configure consent screen";
1. Вкажіть назву застосунку (наприклад, "calendar mcp");
2. Вкажіть авторизовану електронну адресу;
3. Оберіть "External Audience" для обмежень типу користувачів;
4. Вкажіть контактну інформацію, використовуючи ту ж електронну адресу;
5. Прийміть вимоги політики щодо даних користувача.

1. Перейдіть у APIs and Services → Library;
2. Знайдіть "Calendar API";
3. Оберіть перший результат і увімкніть доступ до API;
4. Переконайтеся, що статус API відображається як "Enabled".

1. Перейдіть у розділ Credentials у APIs and Services;
2. Створіть OAuth client ID;
3. Оберіть "Desktop Application" як тип застосунку;
4. Завантажте згенерований JSON-файл із обліковими даними;
5. Тимчасово збережіть файл на робочому столі для зручного доступу (необов'язково).

У Claude скопіюйте та вставте наступний запит:

Create a new folder named projects in my Documents directory to store all MCP servers.
Then clone the repository using: git clone https://github.com/nspady/google-calendar-mcp.git into that folder.
After cloning, move the file gcp-oauth.keys.json from my Desktop into the cloned repo.

Claude автоматично створить папку projects, клонуватиме репозиторій, перемістить файл облікових даних JSON у репозиторій.

• Відкрийте вашу папку Documents;
• Перевірте наявність нової папки projects;
• Усередині клонованого репозиторію знайдіть нову папку (наприклад, google-calendar-mcp). Файл gcp-oauth.keys.json має бути розміщений у репозиторії.

Запустіть наступний запит у Claude:

add next config block to claude config file
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }

• Відкрийте Налаштування → комбінація клавіш: Cmd + , на Mac або Ctrl + , на Windows;
• Перейдіть на вкладку Developer → натисніть Edit Config;
• Відкрийте файл claude_desktop_config.json у текстовому редакторі. JSON-файл повинен містити новий конфігураційний блок із правильним шляхом до вашого файлу облікових даних;
• Якщо все правильно, закрийте вікно налаштувань.

• Повністю закрийте Claude (Mac: Cmd + Q, Windows: Alt + F4);
• Перезапустіть застосунок;
• Після запуску ви будете перенаправлені на сторінку автентифікації Google:
  • Оберіть той самий обліковий запис Google, який використовується для проєкту;
  • Коли з'явиться запит, натисніть Allow для надання доступу;
  • Після повідомлення про успішну автентифікацію закрийте вкладку.

У вашому Terminal (Mac) або Command Line (Windows) почніть з кореневої директорії (за замовчуванням) і перейдіть до папки, де зберігатимуться всі майбутні директорії AI Agent.

• Для переходу до папки використовуйте команду cd folder_name, наприклад:

cd Documents

Щоб створити нову папку, використовуйте команду mkdir new_folder_name, наприклад:

mkdir projects

І перейдіть до цієї нової папки за допомогою команди cd command:

cd projects

Використайте команду git clone link для клонування GitHub repo:

git clone https://github.com/nspady/google-calendar-mcp.git

Перейдіть до новоствореного репозиторію за допомогою команди cd:

cd google-calendar-mcp

Тепер потрібно перемістити файл із обліковими даними до папки з AI-агентом (google_calendar_mcp). Це можна зробити вручну, перемістивши іконку файлу у відкриту папку у файловому провіднику. Або скористатися Терміналом/Командним рядком і скопіювати файл командою cp path/to/file_name ., наприклад:

cp ~/Desktop/gsp-oauth.keys.json .

Крапка (.) в кінці вказує поточну директорію як місце призначення.

Перевірити, чи файл JSON успішно переміщено до папки, можна за допомогою команди ls у Терміналі та знайти ім'я файлу у списку.

Після переміщення файлу видаліть його з початкового розташування (наприклад, Desktop).

У Терміналі/Командному рядку використайте

npm install

Ця команда завантажує всі необхідні пакети та залежності.

Продовжуйте роботу у Терміналі/Командному рядку та виконайте

npm start

Ця команда запускає стандартний стартовий скрипт, визначений у файлі package.json проєкту, який зазвичай запускає застосунок або сервер, у нашому випадку — ініціює процес автентифікації.

1. Вікно браузера відкривається автоматично;
2. Виберіть відповідний обліковий запис Google;
3. Надати дозволи на доступ до календаря;
4. Підтвердити повідомлення "Authentication successful";
5. Закрити вікно браузера.

Інтеграція Claude Desktop

• Скопіюйте блок конфігурації:

    "google-calendar": {
      "command": "node",
      "args": [
        "/path/to/build/index.js"
      ]
    }

• Відкрийте файл конфігурації Claude через Command/Ctrl + , → "Developer" → "Edit Config";
• Відкрийте файл конфігурації claude_desktop_config.json у текстовому редакторі;
• Додайте нову конфігурацію як наступний блок після наявних конфігурацій і перед двома останніми закриваючими фігурними дужками;
• Переконайтеся у правильному синтаксисі JSON з коректним закриттям дужок і комами після кожного блоку конфігурації, крім останнього.

У Терміналі/Командному рядку виконайте

pwd

Скопіюйте повний шлях до директорії та вставте перед "/build" у файлі конфігурації.

Збережіть файл конфігурації Command/Ctrl + S.

1. Повністю перезапустіть Claude Desktop;
2. Перевірте, чи новий сервер з'явився у доступних інструментах.