Google Forms MCP

English | Русский

A1 Google Forms MCP позволяет ИИ-приложению создавать формы Google Forms и управлять ими на простом языке. Создайте опрос, выберите его вопросы, опубликуйте его, когда будете готовы, читайте ответы и используйте уведомления о новых отправках.

Он использует Google Forms API с вашей учётной записью Google. Он различает черновую и опубликованную форму и явно показывает ограничения Forms API, а не создаёт впечатление, что любая задача с формами возможна.

• 13 инструментов. Изучайте структуру форм и ответы, создавайте и редактируйте формы и вопросы, управляйте публикацией и настраивайте Pub/Sub-подписки.

• Публикуйте осознанно. Формы, созданные через API, по умолчанию не опубликованы, поэтому не могут собирать ответы, пока вы их не опубликуете.

• Ответы остаются нетронутыми. API может читать ответы, но не может создавать или изменять их; на сервере нет инструмента, который отправляет ответы.

• Минимальные области Google. Используются forms.body и forms.responses.readonly, без широкого доступа к Drive.

Начните с вопроса, который только читает данные:

Покажи вчерашние ответы на форму обратной связи с клиентами и обобщи ответы в свободной форме.

Подключите сервер · Сценарии использования · Техническая документация

Посмотрите, как это работает, за минуту

Вы: Покажи вопросы и настройки ответов формы обратной связи с клиентами.

Ассистент: Показывает форму, её элементы, опубликована ли она и принимает ли ответы. Ничего не меняется.

Вы: Подготовь обязательный вопрос с оценкой от 1 до 5 под названием «Как вам ваш опыт?» после первого вопроса.

Ассистент: Показывает целевую форму, позицию и предлагаемый вопрос, затем запрашивает подтверждение перед добавлением.

Вы: Подтверждаю.

Ассистент: Добавляет вопрос в форму. Он не публикует и не закрывает форму, если вы не попросите об этом отдельно.

Related MCP server: Google Workspace MCP Server

Содержание

• Быстрый старт

• Что можно попросить сделать

• Как изменяется форма

• Что может измениться

• Получение доступа

• Конфигурация

• Данные, лимиты и фоновая работа

• Техническая документация

• Поддержка

Быстрый старт

Вам нужны Node.js 20+, учётная запись Google и учётные данные OAuth из проекта Google Cloud с включённым Google Forms API.

1. Подготовьте доступ Google OAuth.

2. Добавьте сервер в ваше ИИ-приложение.

3. Задайте приведённый выше вопрос, который ничего не меняет.

В приложении: откройте Settings → Plugins → MCP servers, выберите Add server и добавьте npx -y mcp-google-forms@latest с GOOGLE_FORMS_CLIENT_ID, GOOGLE_FORMS_CLIENT_SECRET и GOOGLE_FORMS_REFRESH_TOKEN.

Из командной строки:

codex mcp add google-forms \
  --env GOOGLE_FORMS_CLIENT_ID=your_client_id \
  --env GOOGLE_FORMS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_FORMS_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-forms@latest

codex mcp list

Документация MCP для Codex

claude mcp add \
  --env GOOGLE_FORMS_CLIENT_ID=your_client_id \
  --env GOOGLE_FORMS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_FORMS_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-forms \
  -- npx -y mcp-google-forms@latest

claude mcp list

Документация MCP для Claude Code

Откройте Settings → Developer → Edit Config и добавьте:

{
  "mcpServers": {
    "google-forms": {
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "your_client_id",
        "GOOGLE_FORMS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_FORMS_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Если Edit Config недоступен, отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows.

Документация MCP для Claude Desktop

Добавьте это в ~/.cursor/mcp.json на macOS/Linux или в %USERPROFILE%\.cursor\mcp.json на Windows:

{
  "mcpServers": {
    "google-forms": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "your_client_id",
        "GOOGLE_FORMS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_FORMS_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Документация MCP для Cursor

Выполните MCP: Open User Configuration и добавьте:

{
  "servers": {
    "google-forms": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "${input:forms_client_id}",
        "GOOGLE_FORMS_CLIENT_SECRET": "${input:forms_client_secret}",
        "GOOGLE_FORMS_REFRESH_TOKEN": "${input:forms_refresh_token}"
      }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "forms_client_id", "description": "Google OAuth client ID" },
    { "type": "promptString", "id": "forms_client_secret", "description": "Google OAuth client secret", "password": true },
    { "type": "promptString", "id": "forms_refresh_token", "description": "Google OAuth refresh token", "password": true }
  ]
}

Проверьте с помощью MCP: List Servers.

Документация MCP для VS Code

Что можно попросить сделать

Просмотр опроса и его ответов

• Покажи вопросы этой формы, настройки ответов и ссылку для респондентов.

• Сколько ответов поступило с понедельника? Обобщи отзывы в свободной форме.

• Покажи один ответ по ID.

Создание и улучшение формы

• Создай форму RSVP с именем, предпочтением по еде и датой прибытия.

• Добавь обязательный вопрос с оценкой, раскрывающимся списком, датой, временем, выбором или текстом.

• Измени порядок вопроса или обнови название, описание, режим теста или сбор электронных писем.

Публикация и подключение уведомлений

• Опубликуй подготовленную форму и покажи её URL для респондентов.

• Прекрати принимать новые ответы, не удаляя форму.

• Создай, продли или удали подписку Cloud Pub/Sub для новых отправок.

Как изменяется форма

1. create_form создаёт форму, которая по умолчанию не опубликована.

2. Вопросы — это элементы, определяемые по их позиции в форме.

3. Публикация делает форму доступной для респондентов; закрытие сбора ответов оставляет её опубликованной, но останавливает новые отправки.

4. Ответы — это отдельная запись только для чтения. API не может отправлять, изменять или удалять ответ респондента.

Вопросы с загрузкой файлов нельзя создать через Forms API, хотя существующие элементы с загрузкой файлов можно читать. Устаревшие формы, созданные до модели публикации Google, могут не поддерживать настройки публикации.

Что может измениться

ИИ-клиент управляет запросами на подтверждение. Сервер помечает инструменты чтения, записи и разрушающие, чтобы клиент мог отличить просмотр от реального изменения.

Получение доступа

Google Forms требует OAuth 2.0; ключа API недостаточно.

1. Создайте или выберите проект Google Cloud и включите Google Forms API.

2. Настройте экран согласия OAuth и создайте OAuth-клиент Desktop app.

3. Авторизуйте учётную запись Google, которая владеет формами или может их редактировать. OAuth 2.0 Playground может получить токен обновления, когда включён параметр Use your own OAuth credentials.

4. Запросите обе области:

   https://www.googleapis.com/auth/forms.body
   https://www.googleapis.com/auth/forms.responses.readonly

Токены обновления OAuth в тестовом режиме могут истекать через семь дней. Если вам нужен долгосрочный доступ, опубликуйте OAuth-приложение или используйте внутреннее приложение в домене Workspace. Относитесь к секрету клиента и токену обновления как к паролям.

Конфигурация

* Укажите либо триаду OAuth, либо токен доступа.

Данные, лимиты и фоновая работа

• Запросы идут в Google Forms. Локальный сервер обновляет токены Google OAuth и вызывает Forms API. Его анонимная телеметрия содержит идентификатор установки, версию пакета, клиент ИИ, версии платформ и имена инструментов — но никогда токены OAuth, данные форм, аргументы инструментов или запросы. Установите ASKADS_TELEMETRY=0, чтобы отказаться от телеметрии.

• Google применяет поминутные квоты. Документированные лимиты: 975 чтений на проект, 450 вызовов list_responses и 375 записей. При 429 сервер использует backoff; чтения также повторяются после сетевых ошибок и ошибок 5xx, а записи не повторяются после неопределённого сбоя.

• Фонового опроса нет. Сервер работает только при вызове. Подписки Pub/Sub могут уведомлять вашу собственную инфраструктуру о новых ответах; если ваше ИИ-приложение поддерживает запланированные задачи, оно также может периодически проверять ответы.

Техническая документация

• Каталог возможностей MCP — страницы, ориентированные на задачи, для каждого инструмента.

• Все инструменты и входные данные

• Документация для разработчиков

• Документация по публикации

• Справочник Google Forms API

Поддержка

Нашли ошибку или нужен сценарий? Создайте issue или напишите в Telegram.