google-chat-mcp

MCP-сервер для Google Chat. Позволяет Claude (Code / Desktop) или любому MCP-клиенту просматривать ваши пространства, читать и искать сообщения, получать ветки и участников, а также — по желанию — отправлять сообщения от вашего имени.

По умолчанию доступен только для чтения. Работает локально через stdio. Refresh-токен хранится с правами 0600 в ~/.google-chat-mcp/.

Инструменты

Имена отправителей берутся из каталога People API (directory.readonly). Если этот API отключен или пользователь внешний, вы получите users/<id> вместо этого — всё остальное продолжает работать.

Related MCP server: google-mcp

Настройка

Требуется учетная запись Google Workspace. Аккаунты потребителей @gmail.com не могут вызывать Chat API (403).

1. Проект Google Cloud (однократно, ~10 мин)

1. console.cloud.google.com → создайте/выберите проект.

2. APIs & Services → Library → включите Google Chat API и People API.

3. Вкладка Google Chat API → Configuration → заполните Имя приложения, URL аватара, Описание; интерактивные функции выключены; видимость для вашего домена. Сохраните.

   Загвоздка: Chat API отклоняет все OAuth-вызовы с 403, пока эта форма не сохранена, даже для read-only авторизации пользователя.

4. Экран согласия OAuth → Внутренний → добавьте области доступа:

   • https://www.googleapis.com/auth/chat.spaces.readonly

   • https://www.googleapis.com/auth/chat.messages.readonly

   • https://www.googleapis.com/auth/chat.memberships.readonly

   • https://www.googleapis.com/auth/directory.readonly

   • https://www.googleapis.com/auth/chat.messages.create (только если нужен send_message)

5. Credentials → Create credentials → OAuth client ID → Desktop app → скачайте JSON. Не храните его ни в одном репозитории.

2. Вход

export GOOGLE_CHAT_CLIENT_SECRET_PATH=/path/to/client_secret.json
npx google-chat-mcp login        # browser opens → sign in with your Workspace account
npx google-chat-mcp whoami       # sanity check

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

claude mcp add google-chat \
  -e GOOGLE_CHAT_CLIENT_SECRET_PATH=/path/to/client_secret.json \
  -- npx -y google-chat-mcp

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "google-chat": {
      "command": "npx",
      "args": ["-y", "google-chat-mcp"],
      "env": { "GOOGLE_CHAT_CLIENT_SECRET_PATH": "/path/to/client_secret.json" }
    }
  }
}

Окружение

Примечания по квотам

Chat API: ~60 запросов/мин/пользователь. Списки пространств и участников кэшируются на 5 минут в процессе; разрешенные имена пользователей кэшируются на диске в ~/.google-chat-mcp/users.json. search_messages — самый затратный — ограничьте его с помощью spaces и since.

Разработка

pnpm install
pnpm dev login
pnpm typecheck && pnpm lint && pnpm build

Node ≥ 22. TypeScript strict, ESM, сборка tsup.

Лицензия

MIT