gworkspace-mcp

Сервер Model Context Protocol для автоматизации Google Workspace: Google Sheets, Apps Script, Drive, Docs, Gmail и триггеров. Создан с использованием FastMCP.

Разработан для использования в Claude Code (или любом другом MCP-совместимом клиенте), чтобы вы могли редактировать проекты Apps Script, манипулировать электронными таблицами, отправлять электронные письма и управлять файлами на Диске прямо во время беседы.

Функции

• Apps Script (9 инструментов) — список, чтение, обновление, создание, развертывание и запуск проектов Apps Script. Гранулярное редактирование файлов, чтобы вам не приходилось переписывать скрипты целиком.

• Sheets (10 инструментов) — чтение/запись диапазонов, пакетные обновления, форматирование, защита, формулы, дашборды.

• Drive (4 инструмента) — список, поиск, перемещение и управление файлами.

• Docs (1 инструмент) — чтение/редактирование Google Docs.

• Gmail (3 инструмента) — создание и отправка электронных писем.

• Triggers (3 инструмента) — управление временными и событийными триггерами Apps Script.

• Connect (1 инструмент) — привязка локального проекта Apps Script к электронной таблице.

Требования

• Python 3.10+

• Проект в Google Cloud со следующими включенными API:

  • Google Sheets API

  • Google Drive API

  • Apps Script API

  • Google Docs API

  • Gmail API

  • Google Calendar API

• Учетные данные OAuth 2.0 для настольных приложений (client_secret.json)

Установка

git clone https://github.com/LeooNic/gworkspace-mcp.git
cd gworkspace-mcp
pip install -e .

Или с помощью uv:

uv pip install -e .

Настройка Google Cloud

1. Перейдите на console.cloud.google.com и создайте проект.

2. Включите указанные выше API в разделе APIs & Services → Library.

3. Перейдите в APIs & Services → OAuth consent screen, настройте его как External и добавьте свой аккаунт Google в качестве тестового пользователя.

4. Перейдите в APIs & Services → Credentials → Create Credentials → OAuth client ID, выберите Desktop app и скачайте JSON-файл.

5. Сделайте учетные данные доступными для сервера одним из следующих способов:

   • Поместите JSON-файл по пути ~/.secrets/gworkspace-mcp/client_secret.json, или

   • Установите GOOGLE_CLIENT_SECRET_PATH=/full/path/to/client_secret.json, или

   • Установите GOOGLE_OAUTH_CLIENT_ID и GOOGLE_OAUTH_CLIENT_SECRET в качестве переменных окружения.

При первом запуске инструмента откроется окно браузера для подтверждения OAuth. Полученный токен сохраняется в ~/.secrets/gworkspace-mcp/token.json и обновляется автоматически.

Регистрация в Claude Code

Добавьте это в ваш settings.json для Claude Code (или ~/.claude.json):

{
  "mcpServers": {
    "gworkspace": {
      "command": "gworkspace-mcp"
    }
  }
}

Если gworkspace-mcp отсутствует в вашем PATH, используйте абсолютный путь к исполняемому файлу, созданному командой pip install -e . (в Windows это обычно C:\Users\<you>\AppData\Local\Programs\Python\Python3XX\Scripts\gworkspace-mcp.exe).

Альтернативный вызов без установки точки входа:

{
  "mcpServers": {
    "gworkspace": {
      "command": "python",
      "args": ["-m", "gworkspace_mcp.server"]
    }
  }
}

Области действия OAuth (Scopes)

Сервер запрашивает следующие области действия:

• spreadsheets, drive, documents, calendar

• script.projects, script.deployments, script.processes, script.metrics

• gmail.send, gmail.compose

• userinfo.email, userinfo.profile

Примечания по безопасности

• Ваши файлы client_secret.json и token.json являются личными — никогда не добавляйте их в репозиторий. Файл .gitignore в репозитории уже исключает их.

• Токены хранятся в ~/.secrets/gworkspace-mcp/.

• Сервер работает локально; он не открывает никаких сетевых портов.

Лицензия

MIT — см. LICENSE.