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

1. У бічному меню перейдіть до "APIs & Services" → "Library";
2. Знайдіть "Gmail API";
3. Виберіть перший результат і натисніть "Enable";
4. Це надає вашому проєкту дозвіл на використання функцій Gmail.

1. Перейдіть на вкладку "Credentials";
2. Якщо буде запропоновано, натисніть "Configure consent screen";
3. Натисніть "Get started";
4. Введіть назву застосунку (наприклад, "gmail agent");
5. Вкажіть свою електронну адресу;
6. Виберіть "External Audience" для типу користувача, якщо використовується загальний акаунт Gmail;
7. Повторно введіть свою електронну адресу, коли буде запропоновано;
8. Прийміть політику щодо даних користувача;
9. Натисніть Continue та Create.

1. Натисніть "Create OAuth Client";
2. Виберіть "Web Application";
3. Прийміть запропоновану назву або змініть її;
4. Натисніть "Add URI";
5. Введіть URI перенаправлення: http://localhost:3000/oauth2callback;
6. Натисніть синю кнопку Create;
7. Завантажте файл облікових даних у форматі JSON;
8. Перейменуйте файл на: gsp-oauth.keys.json.

Перейдіть до кореневої/домашньої директорії:

• Mac: домашня папка Users/user_name або Windows: C:\Users\Your_Username\;
• Використайте Command + Shift + . (Mac) або Ctrl + Shift + . (Windows) для відображення прихованих файлів;
• Створіть нову папку з назвою: .gmail-mcp;
• Перемістіть файл gsp-oauth.keys.json у цю папку;
• Знову використайте Command + Shift + . для приховування папок.

Сервер налаштовано на автоматичний пошук облікових даних у цій директорії.

• Відкрийте Claude із встановленим Desktop Commander MCP. Для швидкого налаштування використовуйте команду Smithery;
• У новому чаті Claude введіть підказку:

run npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude

• Під час виконання Claude попросить дозвіл на використання Desktop Commander MCP. Натисніть Allow always або Allow once;
• Вас буде перенаправлено на сторінку авторизації Google. Виберіть ту ж електронну адресу, що й для Cloud-проєкту. Натисніть Allow для надання доступу до Gmail. Дочекайтеся повідомлення Success message;
• Перезапустіть Claude Desktop. Новий сервер має відображатися як connected.

• Скопіюйте підказку та вставте її у новий або вже відкритий чат Claude:

add next config block to claude config file
{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• Запустіть підказку → Claude оновить конфігураційний файл.
• Переконайтеся, що блок було додано правильно (необов'язково). Перейдіть у Settings (швидкий доступ: Cmd + ,) → Developer → Edit Config → відкрийте файл claude_desktop_config.json у текстовому редакторі;
• Повністю закрийте та знову відкрийте Claude Desktop.

Оновлення конфігураційного файлу

• У Claude Desktop натисніть Command + , (Mac) або Ctrl + , (Windows);
• Натисніть "Edit Config";
• Відкрийте конфігураційний файл у текстовому редакторі;
• Скопіюйте конфігураційний блок;

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    },
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• Вставте його у ваш конфігураційний файл Claude після попереднього конфігураційного блоку та перед двома останніми закриваючими фігурними дужками;
• Збережіть файл (Command/Ctrl + S);
• Повністю закрийте та знову відкрийте Claude Desktop.