Каталог MCP
taylorwilsdon/google_workspace_mcp

taylorwilsdon/google_workspace_mcp

Google Workspace MCP сервер для полного управления сервисами через естественный язык - Gmail, Drive, Calendar, Docs, Sheets и другие. Поддерживает OAuth 2.1 и многопользовательский режим. Идеален д...

README

123 инструмента

Версии

Установить сервер

Google Workspace MCP Server

Full natural language control over Google Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, Contacts, and Chat through all MCP clients, AI assistants and developer tools.

Includes a full featured CLI & Code Mode for use with tools like Claude Code and Codex!

The most feature-complete Google Workspace MCP server, it can do things that Google's own tooling and the built in integrations with Claude and ChatGPT can't even dream of. With Remote OAuth2.1 multi-user support, fine-grained editing tools and the most extensive coverage of any Google Workspace tool in existance, Workspace MCP is in a different class. Offering native OAuth 2.1, stateless mode and external auth server support, it's also the only Workspace MCP you can host for your whole organization centrally & securely!

Support for all free Google accounts & Google Workspace plans (Starter, Standard, Plus, Enterprise, Non Profit) with expanded app options like Chat & Spaces.

Interested in a private, managed cloud instance? That can be arranged.

Инструменты были проиндексированы: 09.09.2026

append_table_rowsвнешний мир

Добавляет строки в структурированную таблицу в Google Sheet. Строки добавляются в конец тела таблицы, автоматически расширяя её диапазон. Сначала используйте list_sheet_tables, чтобы найти ID таблицы.

Добавить строки таблицы

Параметры

spreadsheet_idstringобязательный
Идентификатор электронной таблицы. Обязателен.
table_idstringобязательный
Идентификатор таблицы для добавления данных (получить из list_sheet_tables). Обязательно.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.
valuesstring | any[][]обязательный
Двумерный массив значений для добавления. Каждый внутренний список — это одна строка. Может быть JSON-строкой или списком Python. Обязательный параметр.

batch_modify_gmail_message_labelsвнешний мир

Добавляет или удаляет метки для нескольких сообщений Gmail в одном пакетном запросе. Принимает MESSAGE ids, а не thread ids. Пакетная конечная точка Gmail не возвращает результат по каждому сообщению и молча игнорирует нераспознанные идентификаторы, поэтому по умолчанию инструмент после этого считывает сообщения и сообщает, какие идентификаторы фактически изменились.

Пакетное изменение меток сообщений Gmail

Параметры

add_label_idsstring[]
Список ID меток, которые нужно добавить к сообщениям.
message_idsstring[]обязательный
Предоставляет список идентификаторов сообщений для изменения.
remove_label_idsstring[]
Список идентификаторов меток для удаления из сообщений.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.
verifyboolean
Считывает сообщения обратно и выдаёт результат по каждому id. Стоит одного дополнительного (пакетного) чтения на id. Установите False для очень больших прогонов, где эти затраты важны и допустим непроверенный результат.

batch_update_docвнешний мир

Выполняет несколько низкоуровневых операций с документом в одном атомарном пакетном обновлении. Для обычного текста верхних/нижних колонтитулов используй update_doc_headers_footers. Используй create_header_footer здесь только для продвинутых макетов с разрывами разделов. РЕКОМЕНДУЕМЫЙ ПОРЯДОК РАБОТЫ ПРИ ПОСТРОЕНИИ ДОКУМЕНТОВ: ============================================= Чтобы избежать ошибок при вычислении индексов, строй документы поэтапно: ФАЗА 1 — ВСТАВКА ВСЕГО СОДЕРЖИМОГО (используй end_of_segment=true, без работы с индексами): Добавляй текст, разрывы разделов и разрывы страниц последовательно. Каждая операция добавляет данные в конец тела документа. Индекс не нужен. Пример пакета: [ {"type": "insert_text", "end_of_segment": true, "text": "Report Title\n"}, {"type": "insert_text", "end_of_segment": true, "text": "\nExecutive Summary\n"}, {"type": "insert_text", "end_of_segment": true, "text": "Revenue grew 15%.\n"}, {"type": "insert_section_break", "end_of_segment": true, "section_type": "NEXT_PAGE"}, {"type": "insert_text", "end_of_segment": true, "text": "Detailed Analysis\n"} ] ФАЗА 2 — СОЗДАНИЕ ВЕРХНИХ/НИЖНИХ КОЛОНТИТУЛОВ (если нужно): Для обычного текста колонтитулов используй update_doc_headers_footers (он сам создаёт колонтитул, если его нет, и записывает туда содержимое). Включай операции create_header_footer в пакет, только когда осознанно управляешь макетом, специфичным для разрыва раздела.

Пакетное обновление документа

Параметры

document_idstringобязательный
Идентификатор документа для обновления.
operationsobject[]обязательный
Список словарей операций. Каждая операция ОБЯЗАТЕЛЬНО должна иметь поле 'type'. Все операции принимают необязательный параметр 'tab_id' для указания конкретной вкладки.
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

batch_update_formвнешний мир

Применяет пакетные обновления к Google Форме. Поддерживает добавление, обновление и удаление элементов формы, а также обновление метаданных и настроек. Это основной метод изменения содержимого формы после её создания.

Batch Update Form

Параметры

form_idstringобязательный
Идентификатор формы для обновления.
requestsobject[]обязательный
Список запросов на обновление для применения. Поддерживаемые типы запросов: - createItem: добавляет новый вопрос или элемент контента - updateItem: изменяет существующий элемент - deleteItem: удаляет элемент - moveItem: меняет порядок элемента - updateFormInfo: обновляет название или описание формы - updateSettings: изменяет настройки формы (например, режим викторины)
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

batch_update_presentationвнешний мир

Применить пакетные обновления к презентации Google Slides.

Пакетное обновление презентации

Параметры

presentation_idstringобязательный
Идентификатор презентации, которую нужно обновить.
requestsobject[]обязательный
Список запросов на обновление для применения.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

check_drive_file_public_accessтолько чтениеидемпотентныйвнешний мир

Ищет файл по имени и проверяет, включён ли у него общий доступ по ссылке.

Проверяет публичный доступ к файлу на Диске

Параметры

drive_idstring | null
ID общего диска, по которому нужно ограничить поиск. Когда параметр задан, базовый вызов files.list использует corpora='drive' и указанный driveId. Это необходимо, чтобы надёжно находить файлы, которые находятся только на этом общем диске. Когда параметр равен None, поведение не меняется (применяется стандартный API corpora).
file_namestringобязательный
Имя файла для проверки.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

copy_drive_fileвнешний мир

Создает копию существующего файла Google Drive. Этот инструмент копирует документ-шаблон в новое место, с возможностью задать новое имя. Копия сохраняет все форматирование и содержимое исходного файла.

Копировать файл Drive

Параметры

file_idstringобязательный
ID файла для копирования. Обязательно.
new_namestring | null
Новое имя для скопированного файла. Если не указано, используется «Копия [оригинального имени]».
parent_folder_idstring
Идентификатор папки, в которой должна быть создана копия. По умолчанию — 'root' (Мой диск).
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

create_calendarвнешний мир

Создаёт новый дополнительный календарь Google.

Создаёт календарь

Параметры

descriptionstring | null
Необязательное описание для календаря.
summarystringобязательный
Название нового календаря.
timezonestring | null
Часовой пояс IANA для календаря (например, 'America/New_York').
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

create_docвнешний мир

Создаёт новый Google Doc и опционально вставляет начальное содержимое. После создания тело документа начинается с индекса 1. Новый пустой документ имеет общую длину 2 (один разрыв раздела на индексе 0, один перевод строки на индексе 1). Чтобы собрать сложный документ после создания, используйте batch_update_doc с операциями insert_text, применяя end_of_segment=true, чтобы добавлять содержимое последовательно, не вычисляя индексы. Затем вызовите inspect_doc_structure, чтобы получить точные позиции перед применением форматирования отдельным пакетным вызовом.

Создать документ

Параметры

contentstring
Необязательное начальное содержимое в виде обычного текста для вставки
titlestringобязательный
Заголовок нового документа
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

create_drive_fileвнешний мир

Создает новый файл в Google Drive, поддерживая создание в общих дисках. Принимает прямой текст, встроенные base64-байты или fileUrl для загрузки содержимого. Сохраняет переданные байты без преобразования в Google Docs, Sheets или Slides. Для конвертации в нативные форматы Google используйте соответствующий инструмент import_to_google_*.

Создаёт файл Drive

Параметры

base64_contentstring | null
Байты файла в стандартной base64-кодировке.
base64_sha256string | null
Ожидаемый SHA-256 декодированного base64_content. Рекомендуется для проверки целостности бинарных данных.
contentstring | null
Если указано, содержимое для записи в файл.
content_mime_typestring | null
Тип MIME для загрузок base64_content.
file_namestringобязательный
Имя для нового файла.
fileUrlstring | null
Если указано, получает содержимое файла по этому URL. Поддерживает протоколы file://, http:// и https://.
folder_idstring
Идентификатор родительской папки. По умолчанию используется 'root'. Для общих дисков это должен быть идентификатор папки внутри общего диска.
mime_typestring
MIME-тип файла. По умолчанию — 'text/plain'.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

create_drive_folderвнешний мир

Создаёт новую папку в Google Drive, поддерживая создание в общих дисках.

Создаёт папку Drive

Параметры

folder_namestringобязательный
Имя для новой папки.
parent_folder_idstring
Идентификатор родительской папки. По умолчанию — 'root'. Для общих дисков используйте идентификатор папки внутри этого общего диска.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

create_formвнешний мир

Создаёт новую форму, используя заголовок, указанный в переданном сообщении формы в запросе.

Создать форму

Параметры

descriptionstring | null
Описание формы.
document_titlestring | null
Заголовок документа (отображается во вкладке браузера).
titlestringобязательный
Заголовок формы.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

create_presentationвнешний мир

Создаёт новую презентацию в Google Slides.

Создать презентацию

Параметры

titlestring
Название для новой презентации. По умолчанию установлено «Без названия».
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

create_reactionвнешний мир

Добавляет реакцию-эмодзи к сообщению в Google Chat.

Создать реакцию

Параметры

emoji_unicodestringобязательный
Символ для реакции (например, 👍).
message_idstringобязательный
Имя ресурса сообщения (например, spaces/X/messages/Y).
user_google_emailstringобязательный

create_script_projectвнешний мир

Создаёт новый проект Apps Script.

Создает проект скрипта

Параметры

parent_idstring | null
Необязательный ID папки Drive или ID привязанного контейнера
titlestringобязательный
Название проекта
user_google_emailstringобязательный
Адрес электронной почты пользователя

create_sheetвнешний мир

Создаёт новый лист или дублирует существующий (user_google_email: str, spreadsheet_id: str, sheet_name: Optional[str] = None, source_sheet_name: Optional[str] = None, insert_sheet_index: Optional[int] = None).

Создать лист

Параметры

insert_sheet_indexinteger | null
sheet_namestring | null
source_sheet_namestring | null
spreadsheet_idstringобязательный
user_google_emailstringобязательный

create_spreadsheetвнешний мир

Создает новую Google Таблицу.

Создать таблицу

Параметры

sheet_namesstring[] | null
Список имён листов для создания. Если не указано, создаётся один лист с именем по умолчанию.
titlestringобязательный
Название новой таблицы. Обязательно.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

create_table_with_dataвнешний мир

Создаёт таблицу и заполняет её данными за одну надёжную операцию. КРИТИЧЕСКИ ВАЖНО: СНАЧАЛА ВЫЗОВИТЕ inspect_doc_structure, ЧТОБЫ ПОЛУЧИТЬ ИНДЕКС! ОБЯЗАТЕЛЬНЫЙ ПОРЯДОК ДЕЙСТВИЙ - ВЫПОЛНЯЙТЕ ШАГИ ПО ПОРЯДКУ: Шаг 1: ВСЕГДА сначала вызывайте inspect_doc_structure Шаг 2: Используйте значение 'total_length' из inspect_doc_structure как индекс Шаг 3: Форматируйте данные как двумерный список: [["col1", "col2"], ["row1col1", "row1col2"]] Шаг 4: Вызовите эту функцию с правильным индексом и данными ПРИМЕР ФОРМАТА ДАННЫХ: table_data = [ ["Header1", "Header2", "Header3"], # Строка 0 - заголовки ["Data1", "Data2", "Data3"], # Строка 1 - первая строка данных ["Data4", "Data5", "Data6"] # Строка 2 - вторая строка данных ] КРИТИЧЕСКИЕ ТРЕБОВАНИЯ К ИНДЕКСУ: - НИКОГДА не используйте значения индекса, такие как 1, 2, 10, без предварительного вызова inspect_doc_structure - ВСЕГДА получайте индекс из поля 'total_length' в inspect_doc_structure - Индекс должен быть корректной точкой вставки в документе ТРЕБОВАНИЯ К ФОРМАТУ ДАННЫХ: - Только двумерный список строк - Каждый внутренний список = одна строка таблицы - ВСЕ строки ДОЛЖНЫ иметь одинаковое количество столбцов - Для пустых ячеек используйте пустые строки "", никогда None - После создания используйте debug_table_structure, чтобы проверить результаты

Создаёт таблицу с данными

Параметры

bold_headersboolean
Делать ли первую строку жирной (по умолчанию: true)
document_idstringобязательный
Идентификатор документа для обновления.
header_rowsinteger
Количество начальных строк, помечаемых как повторяющийся заголовок, который появляется после каждого разрыва страницы. Допустимые значения — от 0 до количества строк таблицы (по умолчанию: 0 = нет).
indexintegerобязательный
Позиция документа (ОБЯЗАТЕЛЬНО: получи из inspect_doc_structure параметр 'total_length')
tab_idstring | null
Необязательный идентификатор вкладки для создания таблицы в конкретной вкладке.
table_datastring[][]обязательный
Двумерный список строк - ТОЧНЫЙ формат: [["col1", "col2"], ["row1col1", "row1col2"]]
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

create_versionвнешний мир

Создаёт новую неизменяемую версию скриптового проекта. Версии фиксируют снимок текущего кода скрипта. После создания версии нельзя изменять.

Создать версию

Параметры

descriptionstring | null
Необязательное описание для этой версии.
script_idstringобязательный
Идентификатор проекта скрипта.
user_google_emailstringобязательный
Адрес электронной почты пользователя

debug_docs_runtime_infoтолько чтениеидемпотентныйвнешний мир

Возвращает информацию о среде выполнения/исходном коде для диагностики устаревших экземпляров сервера MCP. Это временный диагностический инструмент, предназначенный для проверки того, какой срез кода загрузил запущенный сервер MCP.

Debug Docs Runtime Info

Параметры

user_google_emailstringобязательный

debug_table_structureтолько чтениеидемпотентныйвнешний мир

ВАЖНЫЙ ИНСТРУМЕНТ ОТЛАДКИ - Используйте его, когда таблицы работают не так, как ожидается. ИСПОЛЬЗУЙТЕ ЕГО НЕМЕДЛЕННО, КОГДА: - Заполнение таблицы поместило данные в неверные ячейки - Появляются ошибки "table not found" - Данные отображаются объединёнными в первой ячейке - Нужно понять существующую структуру таблицы - Планируется использовать populate_existing_table ЧТО ПОКАЗЫВАЕТ ЭТОТ ИНСТРУМЕНТ: - Точные размеры таблицы (строки × столбцы) - Координаты каждой ячейки (строка, столбец) - Текущее содержимое каждой ячейки - Индексы вставки для каждой ячейки - Границы и диапазоны таблицы КАК ЧИТАТЬ ВЫВОД: - "dimensions": "2x3" = 2 строки, 3 столбца - "position": "(0,0)" = первая строка, первый столбец - "current_content": Что на самом деле сейчас находится в каждой ячейке - "insertion_index": Куда будет вставлен новый текст в этой ячейке ИНТЕГРАЦИЯ В РАБОЧИЙ ПРОЦЕСС: 1. После создания таблицы → Используйте его, чтобы проверить структуру 2. Перед заполнением → Используйте его, чтобы спланировать формат данных 3. После неудачного заполнения → Используйте его, чтобы увидеть, что пошло не так 4. При отладке → Сравните массив данных с фактической структурой таблицы

Отлаживает структуру таблицы

Параметры

document_idstringобязательный
ID документа для просмотра
table_indexinteger
Какую таблицу отлаживать (0 = первая таблица, 1 = вторая и т.д.)
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

delete_script_projectвнешний мир

Удаляет проект Apps Script. Это навсегда удаляет проект скрипта. Отменить действие нельзя.

Удалить проект скрипта

Параметры

script_idstringобязательный
ID скриптового проекта для удаления
user_google_emailstringобязательный
Адрес электронной почты пользователя

download_chat_attachmentвнешний мир

Загружает вложение из сообщения Google Chat и сохраняет его на локальный диск. В режиме stdio возвращает локальный путь к файлу для прямого доступа. В режиме HTTP возвращает временную ссылку для скачивания (действует 1 час).

Скачать вложение чата

Параметры

attachment_indexinteger
Индекс вложения для загрузки, начиная с нуля (по умолчанию 0).
message_idstringобязательный
Имя ресурса сообщения (например, spaces/X/messages/Y).
user_google_emailstringобязательный

draft_gmail_messageвнешний мир

Создает черновик письма в аккаунте Gmail пользователя. Поддерживает как новые черновики, так и черновики ответов с необязательными вложениями. Поддерживает функцию Gmail «Send As» для создания черновиков с настроенных адресов-псевдонимов. ОТЛОЖЕННАЯ ОТПРАВКА НЕДОСТУПНА. REST API Gmail не предоставляет параметра времени отправки; функция «Schedule send» доступна только в веб-интерфейсе, и через API нельзя поместить сообщение в папку Scheduled. Не утверждайте, что сообщение было запланировано. Чтобы доставить сообщение в выбранное время, создайте черновик с помощью draft_gmail_message. Внешний планировщик должен сохранить данные сообщения, чтобы затем создать и отправить новое сообщение через send_gmail_message, или вызвать users.drafts.send с ID черновика, возвращенным draft_gmail_message. Либо предложите пользователю запланировать отправку черновика в интерфейсе Gmail.

Создаёт черновик сообщения Gmail.

Параметры

attachmentsobject[] | null
Необязательный список вложений. Каждый элемент может быть: 'url' (получить по URL — работает с URL вложений MCP из get_drive_file_download_url / get_gmail_attachment_content), ЛИБО 'path' (путь к файлу, кодируется автоматически), ЛИБО 'content' (стандартный base64, не urlsafe) + 'filename'. Необязательный 'mime_type'. Необязательный 'content_id' (строка) делает вложение встроенным: оно попадает в часть multipart/related с Content-ID: <content_id> и Content-Disposition: inline, и HTML-тело может ссылаться на него через <img src="cid:<content_id>"> (RFC 2392). Без content_id вложение — обычное multipart/mixed.
bccstring | null
Необязательный адрес электронной почты для скрытой копии.
bodystringобязательный
Тело письма (простой текст).
body_formatenum
Формат тела письма. Используйте 'plain' для обычного текста или 'html' для HTML-содержимого.
ccstring | null
Необязательный адрес электронной почты для копии.
from_emailstring | null
Необязательный псевдоним адреса электронной почты «Send As». Должен быть настроен в настройках Gmail (Settings > Accounts > Send mail as). Если не указан, использутся адрес Send As по умолчанию для аккаунта; если Gmail не возвращает подходящую запись Send-As или доступ к настройкам не авторизован, используется email аутентифицированного пользователя.
from_namestring | null
Необязательное отображаемое имя отправителя (например, 'Peter Hartree'). Если оно указано, заголовок From будет отформатирован как 'Name <email>'.
include_signatureboolean
Определяет, следует ли добавлять подпись Gmail из раздела «Настройки» > «Подпись», если она доступна. По умолчанию — true.
in_reply_tostring | null
Необязательный RFC Message-ID для явного ответа на конкретное сообщение (например, 'message123@gmail.com'). Опустите, чтобы ответить на последнее подходящее сообщение в thread_id.
quote_originalboolean
Определяет, нужно ли включать исходное сообщение в качестве цитируемого ответа. Действует только при указанном thread_id. По умолчанию — false.
referencesstring | null
Необязательная цепочка предков Message-ID. Обычно опускается, когда указан thread_id; сервер выводит цепочку через выбранную цель ответа.
subjectstringобязательный
Тема письма.
thread_idstring | null
Необязательный ID ветки Gmail, в которой нужно ответить. Когда параметр in_reply_to опущен, ответ отправляется на последнее сообщение, не являющееся черновиком и не находящееся в корзине, с RFC-идентификатором сообщения.
tostring | null
Необязательный email получателя.
user_google_emailstringобязательный
Адрес Gmail пользователя. Требуется для аутентификации.

export_doc_to_pdfвнешний мир

Экспортирует документ Google Doc в формат PDF и сохраняет его в Google Drive.

Экспортирует документ в PDF.

Параметры

document_idstringобязательный
ID документа Google для экспорта
folder_idstring
Идентификатор папки Drive для сохранения PDF (необязательно — если не указано, сохраняется в корне)
pdf_filenamestring
Название для PDF-файла (необязательно — если не указано, используется исходное название + «_PDF»)
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

find_and_replace_docвнешний мир

Находит и заменяет текст во всём Google Doc. Расчёт индексов не требуется. Это самый безопасный способ обновить конкретный текст в документе, поскольку не требует знания индексов. Используйте этот инструмент, когда нужно: - Заменить текст-заполнитель (например, {{TITLE}}) реальным содержимым - Обновить конкретные слова или фразы во всём документе - Вносить целевые изменения в текст без риска ошибок индексов Для создания документов с нуля рассмотрите вставку текста с уникальными заполнителями через batch_update_doc, а затем замену их с помощью этого инструмента.

Find and Replace Doc

Параметры

document_idstringобязательный
Идентификатор документа для обновления.
find_textstringобязательный
Текст для поиска
match_caseboolean
Учитывать ли регистр букв точно
replace_textstringобязательный
Текст для замены
tab_idstring | null
Необязательный ID целевой вкладки.
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

format_sheet_rangeвнешний мир

Применяет форматирование к диапазону: цвета, числовые форматы, перенос текста, выравнивание и стили текста. Цвета принимают hex-строки (#RRGGBB). Числовые форматы соответствуют типам Sheets (например, NUMBER, CURRENCY, DATE, PERCENT). Если имя листа не указано, используется первый лист.

Форматировать диапазон листа

Параметры

background_colorstring | null
Шестнадцатеричный цвет фона (например, "#FFEECC").
boldboolean | null
Применять ли полужирное форматирование.
font_sizeinteger | null
Размер шрифта в пунктах.
horizontal_alignmentstring | null
Горизонтальное выравнивание текста - LEFT, CENTER или RIGHT.
italicboolean | null
Применять ли курсивное форматирование?
number_format_patternstring | null
Настраиваемый шаблон для формата числа.
number_format_typestring | null
Тип числового формата в Таблицах (например, «ДАТА»).
range_namestringобязательный
Диапазон в стиле A1 (необязательно с именем листа). Обязательно.
spreadsheet_idstringобязательный
Идентификатор электронной таблицы. Обязателен.
text_colorstring | null
Цвет текста в шестнадцатеричном формате (например, "#000000").
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.
vertical_alignmentstring | null
Вертикальное выравнивание текста — TOP, MIDDLE или BOTTOM.
wrap_strategystring | null
Стратегия переноса текста — WRAP (переносить текст в пределах ячейки), CLIP (обрезать текст по границе ячейки) или OVERFLOW_CELL (разрешить тексту выходить за пределы ячейки в соседние пустые ячейки).

generate_trigger_codeтолько чтениеидемпотентный

Генерирует код Apps Script для создания триггеров. API Apps Script не может создавать триггеры напрямую - они должны быть созданы из самого Apps Script. Этот инструмент генерирует необходимый код.

Генерирует код триггера

Параметры

function_namestringобязательный
Функция, которая выполняется при срабатывании триггера (например, "sendDailyReport")
schedulestring
Детали расписания (в зависимости от trigger_type): - Для time_minutes: «1», «5», «10», «15» или «30» - Для time_hours: «1», «2», «4», «6», «8» или «12» - Для time_daily: час в формате «0»–«23» (например, «9» для 9 утра) - Для time_weekly: «MONDAY», «TUESDAY» и т. д. - Для простых триггеров (on_open, on_edit): не требуется
trigger_typestringобязательный
Тип триггера. Один из: - "time_minutes" (запуск каждые N минут: 1, 5, 10, 15, 30) - "time_hours" (запуск каждые N часов: 1, 2, 4, 6, 8, 12) - "time_daily" (ежедневный запуск в определённый час: 0-23) - "time_weekly" (еженедельный запуск в определённый день) - "on_open" (простой триггер - срабатывает при открытии документа) - "on_edit" (простой триггер - срабатывает при редактировании пользователем) - "on_form_submit" (срабатывает при отправке формы) - "on_change" (срабатывает при изменении содержимого)

get_contactтолько чтениеидемпотентныйвнешний мир

Получает подробную информацию о конкретном контакте.

Get Contact

Параметры

contact_idstringобязательный
Идентификатор контакта (например, "c1234567890" или полное имя ресурса "people/c1234567890").
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_contact_groupтолько чтениеидемпотентныйвнешний мир

Получить сведения о конкретной группе контактов, включая её участников.

Получить группу контактов

Параметры

group_idstringобязательный
Идентификатор контактной группы.
max_membersinteger
Максимум возвращаемых элементов (по умолчанию: 100, максимум: 1000).
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_doc_as_markdownтолько чтениеидемпотентныйвнешний мир

Читает Google Doc и возвращает его в виде чистого Markdown с опциональным контекстом комментариев. В отличие от get_doc_content, который возвращает обычный текст, этот инструмент сохраняет форматирование документа как Markdown: заголовки, жирный/курсив/зачёркнутый текст, ссылки, фрагменты кода, упорядоченные/неупорядоченные списки с вложенностью и таблицы. Когда комментарии включены (по умолчанию), якорный текст каждого комментария, конкретный текст, к которому был прикреплён комментарий, сохраняется, что даёт полный контекст для обсуждения.

Получает документ в формате Markdown

Параметры

comment_modestring
Как отображать комментарии: - "inline": ссылки в стиле сносок, размещённые в месте якорного текста (по умолчанию) - "appendix": все комментарии, сгруппированные внизу, с якорным текстом, оформленным как цитата - "none": комментарии не включаются
document_idstringобязательный
ID документа Google (или полный URL)
include_commentsboolean
Включать ли комментарии (по умолчанию: True)
include_resolvedboolean
Включать ли разрешённые комментарии (по умолчанию: False)
suggestions_view_modestring
Как отображать предложения в возвращаемом содержимом: - "DEFAULT_FOR_CURRENT_ACCESS": по умолчанию, в зависимости от уровня доступа пользователя - "SUGGESTIONS_INLINE": предлагаемые изменения отображаются прямо в документе - "PREVIEW_SUGGESTIONS_ACCEPTED": предпросмотр так, будто все предложения приняты - "PREVIEW_WITHOUT_SUGGESTIONS": предпросмотр так, будто все предложения отклонены
tab_idstring | null
Необязательный идентификатор одной вкладки для чтения (из inspect_doc_structure). Когда он указан, отображается только содержимое этой вкладки, без её дочерних вкладок и без заголовка вкладки. Когда он опущен, отображаются все вкладки.
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

get_doc_contentтолько чтениеидемпотентныйвнешний мир

Извлекает содержимое документа Google Docs или файла Drive (например, .docx), идентифицируемого по document_id. - Нативные документы Google Docs: извлекает содержимое через Docs API. - Файлы Office (.docx и т.д.), хранящиеся в Drive: загружает через Drive API и извлекает текст. Для нативных документов Google Docs возвращаемый текст выровнен по индексам документа: пустые абзацы сохраняются, а каждый нетекстовый элемент, занимающий индекс (встроенный объект, разрыв страницы, ссылка на сноску, ...), отображается как один замещающий символ U+FFFC на индекс. Тело документа начинается с индекса 1, поэтому смещение n в тексте, следующем за "--- CONTENT ---", соответствует индексу документа n + 1, и этот индекс можно передавать напрямую в format_text или delete_text. Таблицы и документы с несколькими вкладками вставляют разделители между частями содержимого, поэтому выравнивание сохраняется до первой таблицы или заголовка вкладки.

Get Doc Content

Параметры

document_idstringобязательный
ID документа Google (или полный URL)
suggestions_view_modestring
Как отображать предложения в возвращаемом содержимом: - "DEFAULT_FOR_CURRENT_ACCESS": по умолчанию, в зависимости от уровня доступа пользователя - "SUGGESTIONS_INLINE": предлагаемые изменения отображаются прямо в документе - "PREVIEW_SUGGESTIONS_ACCEPTED": предпросмотр так, будто все предложения приняты - "PREVIEW_WITHOUT_SUGGESTIONS": предпросмотр так, будто все предложения отклонены
tab_idstring | null
Необязательный ID одной вкладки для чтения (из inspect_doc_structure). Когда указан, возвращается только содержимое этой вкладки без разделителя вкладок, поэтому содержимое остаётся согласованным по индексу с этой вкладкой. Когда не указан, возвращаются все вкладки, разделённые маркерами "--- TAB: ... ---".
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

get_drive_file_contentтолько чтениеидемпотентныйвнешний мир

Извлекает содержимое конкретного файла Google Drive по идентификатору, поддерживает файлы в общих дисках. • Нативные Google Docs, Sheets, Slides → экспортируются как текст / CSV. • Office-файлы (.docx, .xlsx, .pptx) → распаковываются и разбираются через std-lib для извлечения читаемого текста. • PDF → текст извлекается с помощью pypdf, если возможно; для сканов и PDF, содержащих только изображения, выдаётся подсказка для скачивания. • Изображения → возвращаются в base64 с MIME-метаданными для мультимодальных клиентов. • Любой другой файл → скачивается; пытается декодировать UTF-8, иначе помечается как бинарный.

Получает содержимое файла Drive

Параметры

file_idstringобязательный
ID файла Drive.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя.

get_drive_file_download_urlтолько чтениеидемпотентныйвнешний мир

Скачивает файл из Google Drive и сохраняет его на локальный диск. В режиме stdio возвращает локальный путь к файлу для прямого доступа. В режиме HTTP возвращает временный URL для скачивания (действителен в течение 1 часа). Для собственных файлов Google (Docs, Sheets, Slides) экспортирует в полезный формат: - Google Docs -> PDF (по умолчанию) или DOCX, если export_format='docx' - Google Sheets -> XLSX (по умолчанию), PDF, если export_format='pdf', или CSV, если export_format='csv' - Google Slides -> PDF (по умолчанию) или PPTX, если export_format='pptx' Для остальных файлов скачивает исходный формат файла.

Получает URL загрузки файла Drive.

Параметры

export_formatstring | null
Необязательный формат экспорта для нативных файлов Google. Варианты: 'pdf', 'docx', 'xlsx', 'csv', 'pptx'. Если не указан, используются разумные значения по умолчанию (PDF для Docs/Slides, XLSX для Sheets). Для Sheets: поддерживает 'csv', 'pdf' или 'xlsx' (по умолчанию).
file_idstringобязательный
Идентификатор файла Google Drive для скачивания.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_drive_file_permissionsтолько чтениеидемпотентныйвнешний мир

Получает подробные метаданные о файле Google Drive, включая права доступа, идентификаторы родительских папок, владельца и временные метки жизненного цикла.

Получает разрешения файла Drive

Параметры

file_idstringобязательный
Идентификатор файла, для которого нужно проверить права доступа.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_drive_shareable_linkтолько чтениеидемпотентныйвнешний мир

Получает ссылку для общего доступа к файлу или папке Google Drive.

Получает общую ссылку на Drive

Параметры

file_idstringобязательный
ID файла или папки, для которой нужно получить общую ссылку. Обязательно.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_eventsтолько чтениеидемпотентныйвнешний мир

Извлекает события из указанного календаря Google. Можно получить одно событие по ID или несколько событий в заданном временном диапазоне. Можно также искать события по ключевому слову, указав необязательный параметр "query".

Получить события

Параметры

calendar_idstring
Идентификатор календаря для запроса. Используйте 'primary' для основного календаря пользователя. По умолчанию используется 'primary'. Идентификаторы календарей можно получить с помощью list_calendars.
detailedboolean
Возвращает ли подробную информацию о событии, включая описание, местоположение, цвет (colorId), участников и детали участников (статус ответа, организатор, дополнительные флаги). Повторяющиеся экземпляры также сообщают идентификатор родительской серии, необходимый для редактирования всей серии; повторяющиеся серии сообщают свои исходные правила повторения RFC5545; а события, не являющиеся обычными подтверждёнными встречами, сообщают свой тип события (outOfOffice, workingLocation, focusTime) и статус. По умолчанию — False.
event_idstring | null
Идентификатор конкретного события для получения. Если указан, возвращает только это событие и игнорирует параметры фильтрации по времени.
include_attachmentsboolean
Указывает, нужно ли включать информацию о вложениях в подробный вывод событий. Если задано значение True, показывает сведения о вложениях (fileId, fileUrl, mimeType, title) для событий, у которых есть вложения. Работает только при detailed=True. Установите True, когда нужно просмотреть или получить доступ к файлам, прикреплённым к событиям календаря, например к документам встреч, презентациям или другим общим файлам. По умолчанию — False.
max_resultsinteger
Максимальное количество событий, возвращаемых на одной странице. По умолчанию: 25. Игнорируется, если указан event_id.
page_tokenstring | null
Токен для следующей страницы, полученный из предыдущего ответа. Когда single_events=True, также передавайте time_min из поля Pagination ответа как time_min, даже если он не был указан при первом вызове. Все остальные параметры запроса оставьте без изменений. Игнорируется, если указан event_id.
querystring | null
Ключевое слово для поиска по полям событий (summary, description, location). Игнорируется, если указан event_id.
single_eventsboolean
Разворачивает повторяющиеся серии в отдельные экземпляры. По умолчанию установлено значение True для обратной совместимости. Установите значение False с detailed=True, чтобы получить повторяющиеся мастер-события и их точные правила повторения RFC5545 вместо определения периодичности по развернутым экземплярам.
time_maxstring | null
Конец временного диапазона (исключая) в формате RFC3339. Если параметр не указан, учитываются события, начиная с time_min и далее (до max_results). Игнорируется, если указан event_id.
time_minstring | null
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_formтолько чтениеидемпотентныйвнешний мир

Получить форму.

Получить форму

Параметры

form_idstringобязательный
Идентификатор формы, которую нужно получить.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_form_responseтолько чтениеидемпотентныйвнешний мир

Получить один ответ из формы.

Получить ответ формы

Параметры

form_idstringобязательный
Идентификатор формы.
response_idstringобязательный
Идентификатор ответа для получения.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_gmail_attachment_contentвнешний мир

Скачивает вложение из письма и сохраняет на локальный диск. В режиме stdio возвращает локальный путь к файлу для прямого доступа. В режиме HTTP возвращает временный URL для скачивания (действителен 1 час). Может повторно запросить метаданные письма, чтобы определить имя файла и MIME-тип.

Получить содержимое вложения Gmail

Параметры

attachment_idstringобязательный
Идентификатор вложения, которое нужно скачать.
attachment_indexinteger | null
Позиция вложения с отсчётом от нуля из ответа message-content. Когда лимит включён, это позволяет серверу безопасно сопоставлять обновлённые идентификаторы вложений Gmail с текущими метаданными перед скачиванием.
message_idstringобязательный
Идентификатор сообщения Gmail, содержащего вложение.
return_base64boolean
Когда значение равно True, полное вложение включается в ответ в виде стандартной base64-строки (в дополнение к пути к файлу или URL-адресу загрузки). Это полезно для клиентов в изолированной среде, которые не могут получить доступ к URL-адресам локального хоста или локальным путям к файлам MCP-сервера (например, для контейнерных агентов с сетевыми списками разрешений). Возвращаемая base64 использует стандартный алфавит, поэтому её можно напрямую передавать в такие инструменты, как draft_gmail_message, которые ожидают стандартную (не URL-безопасную) base64. Значение по умолчанию False сохраняет текущее поведение и размер ответа.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_gmail_message_contentтолько чтениеидемпотентныйвнешний мир

Получает полное содержимое (тему, отправителя, получателей, текст) конкретного сообщения Gmail.

Получает содержимое письма Gmail

Параметры

body_formatenum
Формат вывода тела. 'text' (по умолчанию) возвращает обычный текст (HTML конвертируется в текст как запасной вариант). 'html' возвращает сырое HTML-тело как есть, без конвертации. 'raw' получает полное сырое MIME-сообщение и возвращает декодированное из base64url содержимое.
fullboolean
Когда значение True, возвращайте ПОЛНОЕ неусечённое сообщение: сохраняйте его в локальном хранилище и ссылайтесь на него через URL загрузки или путь к файлу вместо текста тела, либо встраивайте его в ответ, если на сервере нет файлового хранилища (режим без сохранения состояния). Используйте для сообщений, достаточно больших, чтобы достичь лимита усечения, или когда требуется точное соответствие байтов (сочетайте с body_format='raw' для экспорта в .eml).
message_idstringобязательный
Уникальный идентификатор сообщения Gmail для получения.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_gmail_messages_content_batchтолько чтениеидемпотентныйвнешний мир

Извлекает содержимое нескольких писем Gmail в одном пакетном запросе. Поддерживает до 25 писем за один пакет, чтобы предотвратить исчерпание SSL-соединений.

Получает содержимое писем Gmail пакетно

Параметры

body_formatenum
Формат вывода (применяется только когда format='full'). 'text' (по умолчанию) возвращает обычный текст (HTML преобразуется в текст как запасной вариант). 'html' возвращает исходный HTML-код как есть, без преобразований. 'raw' извлекает полное исходное MIME-сообщение и возвращает содержимое, декодированное с помощью base64url.
formatenum
Формат сообщения. 'full' включает тело, 'metadata' только заголовки.
message_idsstring[]обязательный
Список идентификаторов сообщений Gmail для получения (не более 25 за один пакет).
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_gmail_thread_contentтолько чтениеидемпотентныйвнешний мир

Получает полное содержимое цепочки писем Gmail, включая все сообщения. Опционально также возвращает структурированный анализ владения, чтобы вызывающий мог определить, кто отправил последнее сообщение и кто кому должен ответ, без повторного разбора форматированной строки или повторного вызова инструмента.

Получает содержимое цепочки Gmail

Параметры

body_formatenum
Формат выходных данных тела. 'text' (по умолчанию) возвращает обычный текст (HTML преобразуется в текст как запасной вариант). 'html' возвращает исходное HTML-тело как есть, без преобразования. 'raw' извлекает полное исходное MIME-содержимое каждого сообщения и возвращает тело, декодированное из base64url.
include_analysisboolean
Когда значение равно True, возвращается словарь, содержащий и отформатированное содержимое треды, и структурированный анализ владения (последний отправитель, вердикт по мячу на стороне игрока, количество сообщений от каждого отправителя, участники). По умолчанию — False, в этом случае сохраняется существующая строковая форма возвращаемого значения.
thread_idstringобязательный
Уникальный идентификатор потока Gmail для получения.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_gmail_threads_content_batchтолько чтениеидемпотентныйвнешний мир

Получает содержимое нескольких цепочек писем Gmail в одном пакетном запросе. Поддерживает до 25 цепочек на пакет, чтобы предотвратить истощение SSL-соединений.

Получает содержимое цепочек Gmail пакетно.

Параметры

body_formatenum
Формат выходных данных тела. 'text' (по умолчанию) возвращает обычный текст (HTML преобразуется в текст как запасной вариант). 'html' возвращает исходное HTML-тело как есть, без преобразования. 'raw' извлекает полное исходное MIME-содержимое каждого сообщения и возвращает тело, декодированное из base64url.
thread_idsstring[]обязательный
Список идентификаторов потоков Gmail для получения. Функция автоматически группирует запросы в пакеты по 25.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_messagesтолько чтениеидемпотентныйвнешний мир

Извлекает сообщения из пространства Google Chat.

Получить сообщения

Параметры

message_filterstring | null
Необязательная строка фильтра с использованием синтаксиса фильтров Chat API. Поддерживает createTime и thread.name. Примеры: 'createTime > "2026-03-18T00:00:00-03:00"' 'createTime > "2026-03-18T00:00:00-03:00" AND createTime < "2026-03-19T00:00:00-03:00"' 'thread.name = spaces/X/threads/Y'
order_bystring
page_sizeinteger
space_idstringобязательный
user_google_emailstringобязательный

get_pageтолько чтениеидемпотентныйвнешний мир

Получает сведения о конкретной странице (слайде) в презентации.

Получить страницу

Параметры

include_geometryboolean
Также сообщает о размещении каждого элемента: его преобразовании (перемещение, а также масштабирование/сдвиг, если они не единичные) и собственном размере в сырых EMU. Устанавливайте этот параметр при добавлении элементов в существующую презентацию: это единственный способ узнать поля, межколонные интервалы и ширину контента, которые Slides нигде больше не показывает, и сообщает те же значения, которые записывает batch_update_presentation. По умолчанию равно False, чтобы стоимость токенов вывода по умолчанию не изменилась.
page_object_idstringобязательный
Идентификатор объекта страницы или слайда, который нужно получить.
presentation_idstringобязательный
Идентификатор презентации.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_page_thumbnailтолько чтениеидемпотентныйвнешний мир

Генерирует URL миниатюры для конкретной страницы (слайда) в презентации.

Получить миниатюру страницы

Параметры

page_object_idstringобязательный
Идентификатор объекта страницы/слайда.
presentation_idstringобязательный
Идентификатор презентации.
thumbnail_sizestring
Размер миниатюры («LARGE», «MEDIUM», «SMALL»). По умолчанию — «MEDIUM».
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_presentationтолько чтениеидемпотентныйвнешний мир

Получить подробности о презентации Google Slides.

Получить презентацию

Параметры

include_geometryboolean
Также перечисляет элементы каждого слайда с их размещением - трансформацией (смещение, а также масштабирование/сдвиг, если не единичная) и собственным размером в сырых EMU. Установите этот параметр при добавлении слайдов в существующую презентацию, чтобы новые элементы могли соответствовать её установленным полям и ширине контента. По умолчанию - False.
include_speaker_notesboolean
Также сообщайте заметки докладчика (презентатора) для каждого слайда и идентификатор фигуры, которая их содержит. Передавайте True, когда нужно прочитать или отредактировать заметки: этот идентификатор фигуры — единственная допустимая цель для insertText/deleteText в заметках, а batch_update_presentation записывает заметки, заменяя существующий текст фигуры новым. По умолчанию — False.
presentation_idstringобязательный
Идентификатор презентации для получения.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_script_contentтолько чтениеидемпотентныйвнешний мир

Получает содержимое конкретного файла в проекте.

Get Script Content

Параметры

file_namestringобязательный
Имя файла для получения
script_idstringобязательный
Идентификатор проекта скрипта.
user_google_emailstringобязательный
Адрес электронной почты пользователя

get_script_metricsтолько чтениеидемпотентныйвнешний мир

Получает метрики выполнения для скриптового проекта. Возвращает аналитические данные, включая активных пользователей, общее количество выполнений и неудачные выполнения с течением времени.

Получить метрики скрипта

Параметры

metrics_granularitystring
Гранулярность метрик - "DAILY" или "WEEKLY"
script_idstringобязательный
Идентификатор проекта скрипта.
user_google_emailstringобязательный
Адрес электронной почты пользователя

get_script_projectтолько чтениеидемпотентныйвнешний мир

Получает полные сведения о проекте, включая все исходные файлы.

Получает Script Project

Параметры

script_idstringобязательный
Идентификатор проекта скрипта.
user_google_emailstringобязательный
Адрес электронной почты пользователя

get_search_engine_infoтолько чтениеидемпотентныйвнешний мир

Получает метаданные о Programmable Search Engine.

Получает информацию о поисковом движке.

Параметры

user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_spreadsheet_infoтолько чтениеидемпотентныйвнешний мир

Получает информацию о конкретной таблице, включая её листы.

Получает информацию о таблице.

Параметры

spreadsheet_idstringобязательный
ID таблицы, для которой нужно получить информацию. Обязательно.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_taskтолько чтениеидемпотентныйвнешний мир

Получить детали конкретной задачи.

Получить задачу

Параметры

task_idstringобязательный
Идентификатор задачи для получения.
task_list_idstringобязательный
Идентификатор списка задач, содержащего задачу.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_task_listтолько чтениеидемпотентныйвнешний мир

Получить сведения о конкретном списке задач.

Получить список задач

Параметры

task_list_idstringобязательный
ID списка задач для получения.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

get_versionтолько чтениеидемпотентныйвнешний мир

Получает сведения о конкретной версии.

Получить версию

Параметры

script_idstringобязательный
Идентификатор проекта скрипта.
user_google_emailstringобязательный
Адрес электронной почты пользователя
version_numberintegerобязательный
Номер версии для получения (1, 2, 3 и т. д.)

import_to_google_docвнешний мир

Импортирует файл (Markdown, DOCX, TXT, HTML, RTF, ODT) в формат Google Docs с автоматической конвертацией. Google Drive автоматически преобразует исходный файл в нативный формат Google Docs, сохраняя оформление: заголовки, списки, жирный шрифт, курсив и прочее. Бинарные источники можно передавать напрямую как base64_content. Для пакетных операций лучше использовать file_path для файлов на диске, чтобы вызывающим сторонам не приходилось загружать полное содержимое файлов в свой контекст.

Импортировать в Google Doc

Параметры

base64_contentstring | null
Стандартные байты, закодированные в base64, для бинарного источника, такого как DOCX или ODT.
base64_sha256string | null
Ожидаемый SHA-256 декодированного base64_content. Рекомендуется для проверки целостности бинарных данных.
contentstring | null
Текстовый контент для текстовых форматов. Используйте только для коротких фрагментов или контента, уже находящегося в памяти.
file_namestringобязательный
Название для нового Google Документа (расширение будет проигнорировано).
file_pathstring | null
Локальный путь к файлу или URL вида file:// для любого поддерживаемого формата (MD, TXT, HTML, DOCX, ODT, RTF). Подходит для файлов большего размера, чем content, но file_path всё равно может загрузить файл в память или выполнить чтение без потоковой передачи. Избегайте очень больших файлов, которые могут превысить лимиты памяти или времени; для огромных файлов используйте потоковую/порционную загрузку или альтернативный API.
file_urlstring | null
Удалённый URL для получения файла (http/https).
folder_idstring
Идентификатор родительской папки. По умолчанию — 'root'.
source_formatstring | null
Подсказка формата источника ('md', 'markdown', 'docx', 'txt', 'html', 'rtf', 'odt'). Если не указано, формат определяется автоматически по расширению файла.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

import_to_google_sheetsвнешний мир

Импортирует электронную таблицу (XLSX, XLS, ODS, CSV, TSV) в формат Google Sheets с автоматическим преобразованием. Google Drive автоматически преобразует исходную таблицу в родной формат Google Sheets, сохраняя строки, столбцы, листы и значения. Двоичные источники можно передавать напрямую как base64_content. Для пакетных операций лучше использовать file_path для файлов на диске, чтобы вызывающим не приходилось загружать полное содержимое файлов в свой контекст.

Импортирует в Google Sheets

Параметры

base64_contentstring | null
Стандартные байты в кодировке base64 для источника XLSX, XLS или ODS.
base64_sha256string | null
Ожидаемый SHA-256 декодированного base64_content. Рекомендуется для проверки целостности бинарных данных.
contentstring | null
Текстовое содержимое для текстовых форматов (CSV, TSV). Используйте только для коротких фрагментов или уже загруженного в память контента.
file_namestringобязательный
Название для новой таблицы Google Sheets (расширение будет проигнорировано).
file_pathstring | null
Локальный путь к файлу или URL вида file:// для любого поддерживаемого формата (XLSX, XLS, ODS, CSV, TSV). Подходит для более крупных файлов, чем параметр content, но file_path всё равно может загрузить файл в память или читать его без потоковой обработки. Избегайте очень больших файлов, которые могут превысить лимиты памяти или времени; используйте потоковую или пофрагментную загрузку либо другой API для огромных файлов.
file_urlstring | null
Удалённый URL для загрузки таблицы (http/https).
folder_idstring
Идентификатор родительской папки. По умолчанию — 'root'.
source_formatstring | null
Подсказка исходного формата ('xlsx', 'xls', 'ods', 'csv', 'tsv'). Если не указана, определяется автоматически по расширению file_name.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

import_to_google_slidesвнешний мир

Импортирует презентацию (PPTX, PPT, ODP) в формат Google Slides с автоматическим преобразованием. Google Drive автоматически конвертирует исходную презентацию в нативный формат Google Slides, сохраняя слайды, макеты, текст и изображения. Двоичные источники можно передавать напрямую как base64_content. Для пакетных операций предпочитайте file_path для файлов на диске, чтобы вызывающему коду не приходилось загружать полное содержимое файлов в свой контекст.

Импортирует в Google Slides

Параметры

base64_contentstring | null
Стандартные байты в кодировке base64 для источника PPTX или ODP.
base64_sha256string | null
Ожидаемый SHA-256 декодированного base64_content. Рекомендуется для проверки целостности бинарных данных.
file_namestringобязательный
Название для новой презентации Google Slides (расширение будет проигнорировано).
file_pathstring | null
Локальный путь к файлу или URL вида file:// для любого поддерживаемого формата (PPTX, PPT, ODP). Подходит для файлов большего размера, чем при передаче содержимого, но путь к файлу всё равно может загружать файл в память или выполнять чтение без потоковой передачи. Избегайте очень больших файлов, которые могут превысить лимиты памяти или времени; для огромных файлов используйте потоковую или фрагментированную загрузку либо альтернативный API.
file_urlstring | null
Удалённый URL для загрузки презентации (http/https).
folder_idstring
Идентификатор родительской папки. По умолчанию — 'root'.
source_formatstring | null
Подсказка формата источника ('pptx', 'ppt', 'odp'). Если не указано, автоматически определяется по расширению file_name.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

insert_doc_elementsвнешний мир

Вставляет структурные элементы, такие как таблицы, списки или разрывы страниц, в документ Google Docs.

Вставляет элементы документа

Параметры

columnsinteger
Количество столбцов для таблицы (обязательно для таблицы)
document_idstringобязательный
Идентификатор документа для обновления.
element_typestringобязательный
Тип вставляемого элемента («table», «list», «page_break»)
indexintegerобязательный
Позиция для вставки элемента (с нуля)
list_typestring
Тип списка ("UNORDERED", "ORDERED") (обязательно для списка)
rowsinteger
Количество строк для таблицы (обязательно для таблицы)
textstring
Начальное текстовое содержимое для элементов списка.
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

insert_doc_imageвнешний мир

Вставляет изображение в Google Doc из Drive или по URL.

Вставляет изображение документа.

Параметры

document_idstringобязательный
Идентификатор документа для обновления.
heightinteger
Высота изображения в пунктах (необязательно)
image_sourcestringобязательный
ID файла на Диске или публичный URL изображения
indexintegerобязательный
Позиция для вставки изображения (с нуля)
user_google_emailstringобязательный
Адрес электронной почты пользователя Google
widthinteger
Ширина изображения в пунктах (необязательно)

inspect_doc_structureтолько чтениеидемпотентныйвнешний мир

Важный инструмент для поиска безопасных точек вставки и понимания структуры документа. ИСПОЛЬЗУЙТЕ ЭТО ДЛЯ: - Поиска правильного индекса для вставки таблицы - Понимания структуры документа перед внесением изменений - Определения местоположения существующих таблиц и их позиций - Получения статистики документа и информации о сложности - Проверки структуры конкретных вкладок КРИТИЧЕСКИ ВАЖНО ДЛЯ ОПЕРАЦИЙ С ТАБЛИЦАМИ: ВСЕГДА вызывайте это ПЕРЕД созданием таблиц, чтобы получить безопасный индекс вставки. ЧТО ПОКАЗЫВАЕТ РЕЗУЛЬТАТ: - total_elements: количество элементов документа - total_length: максимальный безопасный индекс для вставки - tables: количество существующих таблиц - table_details: позиция и размеры каждой таблицы - headers / footers: реальные идентификаторы сегментов и предпросмотр для редактирования верхних и нижних колонтитулов - tabs: список доступных вкладок в документе (если не указан tab_id) - empty_paragraphs: количество только переносов строк, без учёта существующих/предложенных якорей объектов - empty_paragraph_ranges: начальные/конечные границы, не более 100 - empty_paragraph_ranges_truncated: были ли пропущены диапазоны - last_paragraph: is_list_item и is_empty, или null, если нет абзацев тела документа Статистика абзацев охватывает абзацы тела верхнего уровня и отображается на верхнем уровне в базовом режиме или в разделе «statistics» в подробном режиме. Диапазоны могут включать обязательные пустые абзацы. Перед очисткой используйте detailed=true, чтобы проверить соседние элементы, форматирование и якоря объектов. Сохраняйте завершающий перенос строки и переносы строк перед таблицами, оглавлениями или разрывами разделов. Конечный диапазон имеет end == total_length и может быть опущен при усечении. ПОРЯДОК ДЕЙСТВИЙ ДЛЯ ВСТАВКИ ТАБЛИЦЫ: Шаг 1: вызовите эту функцию Шаг 2: обратите внимание на значение «total_length» Шаг 3: используйте индекс < total_length для вставки таблицы Шаг 4: создайте таблицу ПОРЯДОК ДЕЙСТВИЙ ДЛЯ ФОРМАТИРОВАНИЯ: После вставки всего текста через batch_update_doc с параметром end_of_segment=true вызовите этот инструмент с detailed=true, чтобы получить точные start_index и end_index для каждого абзаца. Используйте эти индексы напрямую в операциях format_text и update_paragraph_style во втором…

Проверяет структуру документа

Параметры

detailedboolean
Возвращать ли подробную информацию о структуре
document_idstringобязательный
ID документа для просмотра
preview_charsinteger | null
Максимальное количество символов предпросмотра текста абзаца, заголовка и нижнего колонтитула. Передайте 0 или None, чтобы получить полный текст; он нужен для поиска токена внутри абзаца длиннее стандартных 100 символов.
tab_idstring
Необязательный ID вкладки для проверки. Если не указан, проверяется основной документ.
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

list_calendarsтолько чтениеидемпотентныйвнешний мир

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

Показать календари

Параметры

max_resultsinteger | null
Максимальное количество календарей, возвращаемых на одной странице. Если не указано, используется значение по умолчанию API.
page_tokenstring | null
Токен для следующей страницы, взятый из предыдущего ответа.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

list_contact_groupsтолько чтениеидемпотентныйвнешний мир

Вывести список контактных групп (меток) для пользователя.

Вывести список групп контактов

Параметры

page_sizeinteger
Максимальное количество групп для возврата (по умолчанию: 100, максимум: 1000).
page_tokenstring | null
Токен для пагинации.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

list_contactsтолько чтениеидемпотентныйвнешний мир

Выводит список контактов для текущего пользователя.

Список контактов

Параметры

page_sizeinteger
Максимальное количество возвращаемых контактов (по умолчанию: 100, максимум: 1000).
page_tokenstring | null
Токен для пагинации.
sort_orderstring | null
Порядок сортировки: "LAST_MODIFIED_ASCENDING", "LAST_MODIFIED_DESCENDING", "FIRST_NAME_ASCENDING" или "LAST_NAME_ASCENDING".
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

list_deploymentsтолько чтениеидемпотентныйвнешний мир

Выводит список всех развёртываний для проекта скрипта, включая привязанный номер версии каждого развёртывания, чтобы вызывающий код мог проверить, какая версия обслуживается.

Список развертываний

Параметры

script_idstringобязательный
Идентификатор проекта скрипта.
user_google_emailstringобязательный
Адрес электронной почты пользователя

list_docs_in_folderтолько чтениеидемпотентныйвнешний мир

Перечисляет Google Docs в указанной папке Drive. Возвращает: str: Отформатированный список Google Docs в указанной папке.

Вывести список документов в папке

Параметры

folder_idstring
page_sizeinteger
user_google_emailstringобязательный

list_document_commentsтолько чтениеидемпотентныйвнешний мир

Перечисляет все комментарии из Google-документа (опционально max_comments для ограничения результатов).

Перечисляет комментарии документа

Параметры

document_idstringобязательный
max_commentsinteger | null
user_google_emailstringобязательный

list_drive_itemsтолько чтениеидемпотентныйвнешний мир

Перечисляет файлы/папки или контейнеры общих дисков с поддержкой общих дисков. Если указан drive_id, перечисляет элементы внутри этого общего диска. folder_id при этом задаётся относительно этого диска (или используйте drive_id как folder_id для корня). Если drive_id не указан, перечисляет элементы из "My Drive" пользователя и доступных общих дисков (если include_items_from_all_drives равно True). Установите resource_type в "shared_drives", чтобы перечислить контейнеры общих дисков вместо содержимого папок.

Перечисляет элементы Drive

Параметры

corporastring | null
Корпус для запроса ('user', 'drive', 'allDrives'). Если задан drive_id, а corpora равно None, используется 'drive'. Если drive_id не задан, применяются значения по умолчанию API.
detailedboolean
Определяет, включать ли размер, время изменения и ссылку в результаты. По умолчанию — True.
drive_idstring | null
ID общего диска. Если указан, список ограничивается этим диском.
file_typestring | null
Ограничивает результаты по конкретному типу файла. Принимает понятное название ('folder', 'document'/'doc', 'spreadsheet'/'sheet', 'presentation'/'slides', 'form', 'drawing', 'pdf', 'shortcut', 'script', 'site', 'jam'/'jamboard') или любую строку с сырым MIME-типом (например, 'application/pdf'). По умолчанию — None (все типы).
folder_idstring
Идентификатор папки Google Диска. По умолчанию — 'root'. Для общего диска это может быть идентификатор общего диска, чтобы перечислить его содержимое, или идентификатор папки внутри этого общего диска.
include_items_from_all_drivesboolean
Следует ли включать элементы из всех доступных общих дисков, если drive_id не задан. По умолчанию — True.
include_organizersboolean
Когда resource_type="shared_drives", включает субъектов с ролью организатора. Это стоит одного дополнительного вызова API permissions.list на каждый возвращённый общий диск. По умолчанию — False.
order_bystring | null
Порядок сортировки. Список ключей сортировки через запятую с необязательным модификатором 'desc'. Допустимые ключи: 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', 'viewedByMeTime'. Пример: 'modifiedTime desc' или 'folder,modifiedTime desc,name'. По умолчанию — None (стандартный порядок сортировки Drive API).
page_sizeinteger
Максимальное количество элементов для возврата. По умолчанию — 100.
page_tokenstring | null
Токен страницы из nextPageToken предыдущего ответа для получения следующей страницы результатов.
querystring | null
Запрос к общему диску, который используется только при resource_type="shared_drives", например "имя содержит 'Engineering'".
resource_typestring
Что перечислять. Используйте "items" для содержимого папки или "shared_drives" для контейнеров общих дисков. По умолчанию — "items".
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

list_form_responsesтолько чтениеидемпотентныйвнешний мир

Вывести ответы формы.

Список ответов формы

Параметры

form_idstringобязательный
Идентификатор формы.
page_sizeinteger
Максимальное количество возвращаемых ответов. По умолчанию — 10.
page_tokenstring | null
Токен для получения следующей страницы результатов.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

list_gmail_filtersтолько чтениеидемпотентныйвнешний мир

Перечисляет все фильтры Gmail, настроенные в почтовом ящике пользователя.

Список фильтров Gmail

Параметры

user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

list_gmail_labelsтолько чтениеидемпотентныйвнешний мир

Перечисляет метки в учетной записи Gmail пользователя.

Выводит список меток Gmail

Параметры

compactboolean
Возвращает минимальный JSON {"count", "labels": [{"id", "name"}]} отсортированный по имени, вместо форматированного текстового списка. Для вызывающих, которые парсят результат, например, при обновлении кэша меток.
include_systemboolean
Включает системные метки Gmail (INBOX, SENT, ...). Устанавливает значение False, чтобы возвращать только пользовательские метки.
prefixstring | null
Возвращает только те метки, чьи имена начинаются с этой точной (с учётом регистра) строки. users.labels.list не поддерживает фильтрацию, поэтому здесь получается полный список и сужается уже он: это уменьшает то, что получает вызывающий код, а не сам API-запрос.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

list_presentation_commentsтолько чтениеидемпотентныйвнешний мир

Вывести список всех комментариев из Google Presentation (опциональный max_comments для ограничения количества результатов).

Список комментариев презентации

Параметры

max_commentsinteger | null
presentation_idstringобязательный
user_google_emailstringобязательный

list_script_processesтолько чтениеидемпотентныйвнешний мир

Выводит список недавних процессов выполнения скриптов пользователя.

Список процессов скриптов

Параметры

page_sizeinteger
Количество результатов (по умолчанию: 50)
script_idstring | null
Фильтр по ID скрипта (необязательно)
user_google_emailstringобязательный
Адрес электронной почты пользователя

list_script_projectsтолько чтениеидемпотентныйвнешний мир

Перечисляет проекты Google Apps Script, доступные пользователю. Использует Drive API для поиска файлов Apps Script.

Выводит список скриптовых проектов

Параметры

page_sizeinteger
Количество результатов на странице (по умолчанию: 50)
page_tokenstring | null
Токен для пагинации (необязательно)
user_google_emailstringобязательный
Адрес электронной почты пользователя

list_sheet_tablesтолько чтениеидемпотентныйвнешний мир

Выводит список всех структурированных таблиц в электронной таблице с их ID, названиями, диапазонами и информацией о столбцах. Используйте это, чтобы найти ID таблиц для append_table_rows.

Список таблиц листа

Параметры

spreadsheet_idstringобязательный
Идентификатор электронной таблицы. Обязателен.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

list_spacesтолько чтениеидемпотентныйвнешний мир

Перечисляет пространства Google Chat (комнаты и личные сообщения), доступные пользователю. Возвращает: str: Отформатированный список пространств Google Chat, доступных пользователю.

Список пространств

Параметры

page_sizeinteger
space_typestring
user_google_emailstringобязательный

list_spreadsheet_commentsтолько чтениеидемпотентныйвнешний мир

Выводит список всех комментариев из Google Spreadsheet (опционально max_comments, чтобы ограничить количество результатов).

Выводит список комментариев таблицы

Параметры

max_commentsinteger | null
spreadsheet_idstringобязательный
user_google_emailstringобязательный

list_spreadsheetsтолько чтениеидемпотентныйвнешний мир

Перечисляет таблицы из Google Диска, к которым у пользователя есть доступ.

Выводит список электронных таблиц

Параметры

max_resultsinteger
Максимальное количество возвращаемых таблиц. По умолчанию: 25.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

list_task_listsтолько чтениеидемпотентныйвнешний мир

Вывести все списки задач для пользователя.

Вывести список списков задач

Параметры

max_resultsinteger
Максимальное количество списков задач для возврата (по умолчанию: 1000, максимум: 1000).
page_tokenstring | null
Токен для пагинации.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

list_tasksтолько чтениеидемпотентныйвнешний мир

Вывести все задачи из указанного списка задач.

List Tasks

Параметры

completed_maxstring | null
Верхняя граница для даты завершения (RFC 3339 timestamp).
completed_minstring | null
Нижняя граница для даты завершения (временная метка RFC 3339).
due_maxstring | null
Верхняя граница срока выполнения (временная метка RFC 3339).
due_minstring | null
Нижняя граница для крайнего срока (временная метка RFC 3339).
max_resultsinteger
Максимальное количество возвращаемых задач. (по умолчанию: 20, максимум: 10000).
page_tokenstring | null
Токен для пагинации.
show_assignedboolean
Включать ли назначенные задачи (по умолчанию: False).
show_completedboolean
Включает ли завершённые задачи (по умолчанию: True). Обратите внимание, что show_hidden также должен быть True, чтобы показывать задачи, завершённые в собственных клиентах, таких как веб-интерфейс и мобильные приложения Google.
show_deletedboolean
Включать ли удалённые задачи (по умолчанию: False).
show_hiddenboolean
Включать ли скрытые задачи (по умолчанию: False).
task_list_idstringобязательный
Идентификатор списка задач, из которого извлекаются задачи.
updated_minstring | null
Нижняя граница времени последнего изменения (отметка времени RFC 3339).
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

list_versionsтолько чтениеидемпотентныйвнешний мир

Выводит список всех версий скриптового проекта.Версии: неизменяемые снимки вашего скриптового кода. Они создаются при развёртывании или явном создании версии.

Список версий

Параметры

script_idstringобязательный
Идентификатор проекта скрипта.
user_google_emailstringобязательный
Адрес электронной почты пользователя

manage_conditional_formattingвнешний мир

Управляет правилами условного форматирования в Google Sheets. Позволяет добавлять, обновлять и удалять правила условного форматирования с помощью одного инструмента.

Управление условным форматированием

Параметры

actionstringобязательный
Операция, которую нужно выполнить. Она должна быть одной из: "add", "update" или "delete".
background_colorstring | null
Шестнадцатеричный цвет фона, который применяется, когда условие совпадает. Используется командами "add" и "update".
condition_typestring | null
Тип условия Sheets (например, NUMBER_GREATER, TEXT_CONTAINS, DATE_BEFORE, CUSTOM_FORMULA). Обязателен для "add". Необязателен для "update" (сохраняет существующий тип, если не указан).
condition_valuesstring | string | integer | number[] | null
Значения для условия; принимает список или JSON-строку, представляющую список. Зависит от condition_type. Используется операциями "add" и "update".
gradient_pointsstring | object[] | null
Список (или JSON-список) точек градиента для цветовой шкалы. Если он указан, создаётся правило градиента, а логические параметры игнорируются. Используется в операциях "add" и "update".
range_namestring | null
Диапазон в стиле A1 (опционально с именем листа). Обязателен для "add". Необязателен для "update" (сохраняет существующие диапазоны, если не указан). Не используется для "delete".
rule_indexinteger | null
Индекс правила, начинающийся с нуля. Для "add" опционально указывает позицию вставки. Обязателен для "update" и "delete".
sheet_namestring | null
Имя листа для поиска правила, когда range_name не указан. По умолчанию используется первый лист. Применяется в операциях "update" и "delete".
spreadsheet_idstringобязательный
Идентификатор электронной таблицы. Обязателен.
text_colorstring | null
Шестнадцатеричный цвет текста, который применяется, когда условие совпадает. Используется в 'add' и 'update'.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

manage_contactвнешний мир

Создаёт, обновляет или удаляет контакт. Объединённый инструмент, заменяющий create_contact, update_contact и delete_contact.

Управление контактом

Параметры

actionenumобязательный
Действие, которое нужно выполнить: "create", "update" или "delete".
addressstring | null
Улица и номер дома (для создания/обновления).
birthdaystring | null
День рождения в формате 'ГГГГ-ММ-ДД', 'ММ-ДД' (без года) или 'очистить'/'' для удаления.
contact_idstring | null
Идентификатор контакта. Необходим для действий «обновление» и «удаление».
emailstring | null
Устаревший адрес электронной почты. Используйте emails=[{"address":..., "type":"other"}].
emailsobject[] | null
Список словарей email {address, type?}.
emails_modeenum
Как обновлять электронные письма при значении "update": "merge" (по умолчанию), "replace" или "remove".
family_namestring | null
Фамилия (для создания/обновления).
given_namestring | null
Имя (для создания/обновления).
job_titlestring | null
[УСТАРЕЛО] Должность. Используйте organizations=[{"title":...}].
nicknamesobject[] | null
Список словарей никнеймов {value, type?}. Полезен для двуязычных контактов (например, альтернативные формы на иврите/английском). И Android-диалер, и поиск в WhatsApp индексируют никнеймы, что обеспечивает поиск между разными системами письма. Поддерживаемые типы: default, alternate, maiden_name, initials, other и т. д.
nicknames_modeenum
Как обновлять никнеймы с помощью 'update': 'merge' (по умолчанию), 'replace' или 'remove'.
notesstring | null
Дополнительные примечания (для создания/обновления).
organizationstring | null
[УСТАРЕЛО] Название компании. Используйте organizations=[{"name":...}].
organizationsobject[] | null
Список org-словарей {name?, title?, department?, jobDescription?, type?}.
organizations_modeenum
Как обновить организации при "update": "merge" (по умолчанию), "replace" или "remove".
phonestring | null
[УСТАРЕЛО] Один номер телефона. Используйте phones=[{"number":..., "type":"mobile"}].
phonesobject[] | null
Список телефонных словарей {number, type?}. Поддерживаемые типы: mobile, work, home, main, workMobile, internal, other и др. Используйте type="internal" для внутренних коротких номеров АТС (например, 250, 301). Номер хранится отдельно, без префикса +, и отображается как "Internal: 250".
phones_modeenum
Как обновить телефоны при "update": "merge" (по умолчанию), "replace" или "remove". merge = чтение-изменение-запись с дедупликацией по canonicalForm/нормализованному значению. replace = перезапись всех телефонов предоставленным списком. remove = удаление телефонов, совпадающих с предоставленными номерами.
relationsobject[] | null
Список словарей отношений {person, type?}. Поддерживаемые типы: spouse, child, parent, friend, manager, assistant и др.
relations_modeenum
Как обновить связи в параметре "update": "merge" (по умолчанию), "replace" или "remove".
urlsobject[] | null
Список словарей URL {value, type?}. Поддерживаемые типы: homepage, blog, profile, work, ftp, reservations, other и др.
urls_modeenum
Как обновлять URL-адреса с помощью параметра "update": "merge" (по умолчанию), "replace" или "remove". merge дедуплицирует по нормализованному URL (в нижнем регистре, с удалённым завершающим слэшем).
user_definedobject[] | null
Список словарей пользовательских полей {ключ, значение}. Полезно для структурированных данных, таких как номера счетов, идентификаторы или пользовательские даты.
user_defined_modeenum
Как обновить пользовательские поля при "update": "merge" (по умолчанию), "replace" или "remove". merge переопределяет значение по совпадающему ключу; новые ключи добавляются.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

manage_contact_groupвнешний мир

Создаёт, обновляет, удаляет группу контактов или изменяет её участников. Объединённый инструмент, заменяющий create_contact_group, update_contact_group, delete_contact_group и modify_contact_group_members.

Управление группой контактов

Параметры

actionstringобязательный
Выполняемое действие: "create", "update", "delete" или "modify_members".
add_contact_idsstring[] | null
Идентификаторы контактов для добавления (для «modify_members»).
delete_contactsboolean
Если True и действие — «delete», также удаляет контакты в группе (по умолчанию: False).
group_idstring | null
ID группы контактов. Требуется для действий "update", "delete" и "modify_members".
namestring | null
Название группы. Требуется для действий «create» и «update».
remove_contact_idsstring[] | null
Идентификаторы контактов для удаления (для "modify_members").
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

manage_contacts_batchвнешний мир

Массовое создание, обновление или удаление контактов. Объединённый инструмент, заменяющий batch_create_contacts, batch_update_contacts и batch_delete_contacts.

Пакетное управление контактами

Параметры

actionenumобязательный
Действие, которое нужно выполнить: "create", "update" или "delete".
contact_idsstring[] | null
Список идентификаторов контактов для действия 'delete'.
contactsobject[] | null
Список словарей контактов для действия «create». Каждый словарь может содержать: given_name, family_name, phones, emails, organizations, notes, address. Устаревшие: phone, email, organization, job_title.
fieldenum | null
Для действия 'update' — единственное поле People API, которое обновляется во всех контактах этого пакета. Обязательное. Должно быть одним из: names, phoneNumbers, emailAddresses, organizations, nicknames, urls, userDefined, relations, biographies, addresses, birthdays. Использование одного поля на пакетный вызов предотвращает случайную потерю данных, когда объединённый updateMask перезаписывает несвязанные поля.
updatesobject[] | null
Список словарей обновления для действия "update". Каждый словарь должен содержать contact_id и может содержать те же поля, что и contacts.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

manage_deploymentвнешний мир

Управляет развертываниями Apps Script. Поддерживает создание, обновление и удаление развертываний.

Управление развертыванием

Параметры

actionstringобязательный
Выполняемое действие — «create», «update» или «delete»
deployment_idstring | null
Идентификатор развертывания (требуется для обновления и удаления)
descriptionstring | null
Описание развертывания (обязательно для создания; необязательно для обновления, если указан version_number)
script_idstringобязательный
Идентификатор проекта скрипта.
user_google_emailstringобязательный
Адрес электронной почты пользователя
version_descriptionstring | null
Необязательное описание версии (только для создания)
version_numberinteger | null
Номер версии, на которую следует перевести развёртывание (только для обновления). Требуется для перевода развёртывания на новую версию скрипта.

manage_doc_tabвнешний мир

Управляет вкладками документов: создаёт, переименовывает, удаляет или заполняет из Markdown.

Управляет вкладкой документа.

Параметры

actionenumобязательный
Действие для выполнения - "create", "rename", "delete" или "populate_from_markdown"
document_idstringобязательный
Идентификатор документа
indexinteger | null
Индекс позиции для новой вкладки, отсчёт от нуля среди соседних элементов (обязателен для создания).
markdown_textstring | null
Markdown-исходник для рендеринга (только для populate_from_markdown)
parent_tab_idstring | null
Необязательный идентификатор родительской вкладки для вложения (только при создании)
replace_existingboolean
Очищает содержимое вкладки перед вставкой Markdown (по умолчанию True)
tab_idstring | null
Tab ID (требуется для rename, delete и populate_from_markdown; используйте inspect_doc_structure для поиска ID)
titlestring | null
Заголовок вкладки (обязателен при создании; используется при переименовании)
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

manage_document_commentвнешний мир

Управляет комментариями в Google Документе. Действия: - create: Создает новый комментарий на уровне документа. Требует comment_content. Примечание: Drive API не может привязывать комментарии к конкретному тексту, это умеет только интерфейс Google Docs. - reply: Отвечает на комментарий. Требует comment_id и comment_content. - resolve: Разрешает комментарий. Требует comment_id.

Управляет комментарием документа

Параметры

actionstringобязательный
comment_contentstring | null
comment_idstring | null
document_idstringобязательный
user_google_emailstringобязательный

manage_drive_accessвнешний мир

Единый инструмент для управления правами доступа к файлам и папкам Google Drive. Поддерживает выдачу, массовую выдачу, обновление, отзыв разрешений и передачу прав владения файлами — все через единую точку входа.

Управление доступом к Drive

Параметры

actionstringобязательный
Действие по управлению доступом, которое нужно выполнить. Обязательно. Одно из: - "grant": Предоставляет доступ одному пользователю, группе, домену или всем. - "grant_batch": Предоставляет доступ нескольким получателям за один вызов. - "update": Изменяет существующее разрешение (роль или срок действия). - "transfer_owner": Передаёт право владения файлом другому пользователю.
allow_file_discoveryboolean | null
Для общих доступов 'domain'/'anyone': указывает, отображается ли файл в поиске. Используется операцией 'grant'.
email_messagestring | null
Настраиваемое письмо для уведомлений. Используется в grant и grant_batch.
expiration_timestring | null
Срок действия в формате RFC 3339 (например, "2025-01-15T00:00:00Z"). Используется командами "grant" и "update".
file_idstringобязательный
Идентификатор файла или папки. Обязательно.
move_to_new_owners_rootboolean
Перемещает файл в корень My Drive нового владельца. По умолчанию — false. Используется функцией "transfer_owner".
new_owner_emailstring | null
Электронная почта нового владельца. Обязательно для "transfer_owner".
permission_idstring | null
Идентификатор разрешения для изменения или удаления. Требуется для действий «обновить» и «отозвать».
recipientsobject[] | null
Список объектов получателей для "grant_batch". Каждый должен содержать: email (str), role (str, необязательно), share_type (str, необязательно), expiration_time (str, необязательно). Для доменных шарингов используйте поле 'domain' вместо 'email'.
rolestring | null
Роль разрешения — «reader», «commenter» или «writer». Используется в «grant» (по умолчанию «reader») и «update».
send_notificationboolean
Определяет, нужно ли отправлять уведомления по электронной почте. По умолчанию - True. Используется в "grant" и "grant_batch".
share_typestring
Тип общего доступа — 'user', 'group', 'domain' или 'anyone'. Используется в "grant". По умолчанию — 'user'.
share_withstring | null
Адрес электронной почты (пользователь/группа), имя домена (домен) или опустите для «anyone». Используется в «grant».
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

manage_eventвнешний мир

Управляет событиями календаря. Поддерживает создание, обновление, удаление и RSVP.

Управляет событием

Параметры

actionstringобязательный
Выполняемое действие - "create", "update", "delete" или "rsvp".
add_google_meetboolean | null
Добавлять или удалять встроенную Google Meet.
attachmentsstring[] | null
Список URL-адресов или идентификаторов файлов Google Drive для прикрепления. При action="update" это заменяет существующие вложения события, а не добавляет к ним, в соответствии с семантикой метода patch в Calendar API.
attendeesstring[] | object[] | null
Адреса электронной почты участников или объекты.
calendar_idstring
Идентификатор календаря (по умолчанию: 'primary').
color_idstring | null
ID цвета события (1-11, только при обновлении).
conference_dataobject | null
Сырые данные conferenceData из Google Calendar для подключения сторонней конференции (Zoom/Webex/Teams аддон). Используйте это для полного контроля; взаимоисключающе с параметрами conference_provider и add_google_meet. Только для создания и обновления.
conference_idstring | null
Необязательный идентификатор конференции/встречи на стороне провайдера.
conference_passcodestring | null
Необязательный код доступа для сторонней конференции.
conference_providerstring | null
Вспомогательная функция более высокого уровня: имя стороннего провайдера (например, "zoom", "webex", "teams"). Требует conference_uri. MCP создаёт блок addOn conferenceData внутренне. (только для создания/обновления)
conference_uristring | null
Ссылка для подключения к сторонней конференции (например, "https://zoom.us/j/123456789"). Обязательна, когда задан conference_provider.
descriptionstring | null
Описание события.
end_timestring | null
Время окончания в формате RFC3339 (обязательно для создания).
end_timezonestring | null
Часовой пояс IANA только для конечной границы, переопределяющий timezone. См. start_timezone.
event_idstring | null
Идентификатор события (требуется для обновления и удаления).
guests_can_invite_othersboolean | null
Могут ли участники приглашать других.
guests_can_modifyboolean | null
Могут ли участники вносить изменения.
guests_can_see_other_guestsboolean | null
Могут ли участники видеть других гостей.
locationstring | null
Место проведения мероприятия.
recurrencestring[] | null
Правила повторения RFC5545 для повторяющегося события, например ["RRULE:FREQ=WEEKLY;COUNT=10"].
remindersstring | object[] | null
Пользовательские объекты напоминаний.
responsestring | null
Ответ RSVP — «accepted», «declined», «tentative» или «needsAction» (только для действия rsvp).
rsvp_commentstring | null
Необязательное сообщение для включения в ответ RSVP (только для действия rsvp).
send_updatesstring | null
Поведение уведомлений для create, update, delete и rsvp — "all" (по умолчанию), "externalOnly" или "none".
start_timestring | null
Время начала в формате RFC3339 (обязательно для создания).
start_timezonestring | null
Таймзона IANA только для начальной границы, переопределяющая таймзону. Используйте для событий, у которых два конца находятся в разных зонах: например, перелет, вылетающий в 13:45 по «Asia/Jerusalem» и приземляющийся в 17:50 по «Europe/Amsterdam», это одно событие, описанное в двух зонах. Передача одной таймзоны для такого события молча переписывает локальное время одного из концов.
summarystring | null
Название события (обязательно при создании).
timezonestring | null
Часовой пояс IANA применяется к обеим границам (например, "America/New_York"). Переопределяется для каждой границы параметрами start_timezone/end_timezone.
transparencystring | null
"непрозрачный" (занятый) или "прозрачный" (свободный).
use_default_remindersboolean | null
Использовать ли напоминания по умолчанию.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.
visibilitystring | null
"default", "public", "private" или "confidential".

manage_focus_timeвнешний мир

Управляет событиями Focus Time в Google Calendar. Эти специальные события автоматически отклоняют приглашения на встречи и по умолчанию устанавливают статус чата пользователя в Do Not Disturb, помогая защищать блоки беспрерывного рабочего времени.

Управляет временем фокусировки

Параметры

actionstringобязательный
Выполняемое действие — «создать», «перечислить», «обновить» или «удалить».
auto_decline_modestring | null
Как обрабатывать конфликтующие приглашения. Одно из: "declineAllConflictingInvitations" (по умолчанию), "declineOnlyNewConflictingInvitations", "declineNone".
calendar_idstring
Идентификатор календаря. По умолчанию используется значение 'primary'. События статуса Focus Time находятся в основных календарях, поэтому используйте 'primary' или идентификатор/email основного календаря пользователя, а не идентификатор вторичного календаря.
chat_statusstring | null
Статус Google Chat во время фокусированного времени. Поддерживает "doNotDisturb" (по умолчанию) и "available".
decline_messagestring | null
Сообщение, включаемое при автоматическом отклонении приглашений.
descriptionstring | null
Описание события. Полезно для добавления контекста о том, для чего предназначено время фокусировки.
end_timestring | null
Дата/время окончания (не включается в диапазон). Формат тот же, что и у start_time. Например, для одного полного дня 5 апреля укажите start_time='2026-04-05' и end_time='2026-04-06'. Обязательно для создания.
event_idstring | null
Event ID. Требуется для действий «update» и «delete».
max_resultsinteger
Для действия 'list': максимальное количество возвращаемых событий. По умолчанию — 10.
recurrencestring[] | null
Правила повторения RFC5545 для повторяющейся серии Focus Time, например ["RRULE:FREQ=WEEKLY;COUNT=10"].
start_timestring | null
Начальная дата/время. Используйте 'YYYY-MM-DD' для полного дня или RFC3339 для частичного дня (например, '2024-04-05T09:00:00Z'). Значения только с датой автоматически преобразуются в dateTime (от полуночи до полуночи). Обязательно для создания.
summarystring | null
Отображает текст в календаре. По умолчанию — «Focus Time».
time_maxstring | null
Для действия 'list': конец временного диапазона.
time_minstring | null
Для действия «list»: начало временного диапазона. По умолчанию — текущее время. Повторяющиеся серии разворачиваются в отдельные экземпляры в запрошенном диапазоне.
timezonestring | null
Часовой пояс для события (например, "America/New_York", "Europe/London"). Обязателен при использовании значений только с датой или значений даты и времени без явного смещения UTC.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

manage_gmail_filterвнешний мир

Управляет фильтрами Gmail. Поддерживает создание и удаление фильтров.

Управляет фильтром Gmail

Параметры

actionstringобязательный
Выполняемое действие - «create» или «delete».
criteriaobject | null
Объект критериев фильтра (обязателен для создания).
filter_actionobject | null
Объект фильтра действия (обязателен для создания). Назван 'filter_action', чтобы избежать затенения параметра 'action'.
filter_idstring | null
Идентификатор фильтра для удаления (обязательное поле для удаления).
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

manage_gmail_labelвнешний мир

Управляет метками Gmail: создаёт, обновляет или удаляет метки.

Управление метками Gmail

Параметры

actionenumобязательный
Действие, которое нужно выполнить над меткой.
background_colorstring | null
Цвет фона метки в виде hex-строки, например "#fb4c2f". Задаётся вместе с text_color; Gmail требует оба значения. Gmail принимает только собственную палитру, и неподдерживаемое значение отклоняется до отправки запроса. Цвета применяются к пользовательским меткам, а не к системным.
clear_colorboolean
При обновлении удаляет текущий цвет метки. Не комбинируется с background_color или text_color.
label_idstring | null
Label ID. Требуется для операций обновления и удаления.
label_list_visibilityenum
Отображается ли метка в списке меток.
message_list_visibilityenum
Отображается ли метка в списке сообщений.
namestring | null
Название метки. Требуется при создании, необязательно при обновлении.
text_colorstring | null
Цвет текста метки в виде hex-строки, например "#ffffff". Задаётся вместе с background_color. Та же палитра. При обновлении, если опустить оба параметра, цвет текста метки сохраняется.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

manage_out_of_officeвнешний мир

Управляет событиями Out of Office в Google Календаре. Эти специальные события автоматически отклоняют приглашения на встречи и устанавливают статус пользователя "Out of office" во всем Google Workspace.

Управление Out of Office

Параметры

actionstringобязательный
Выполняемое действие — «создать», «перечислить», «обновить» или «удалить».
auto_decline_modestring | null
Как обрабатывать конфликтующие приглашения. Одно из: "declineAllConflictingInvitations" (по умолчанию), "declineOnlyNewConflictingInvitations", "declineNone".
calendar_idstring
Идентификатор календаря. По умолчанию — 'primary'. События статуса «Вне офиса» находятся в основных календарях, поэтому используйте 'primary' или основной идентификатор/адрес электронной почты календаря пользователя, а не вторичный идентификатор календаря.
decline_messagestring | null
Сообщение, включаемое при автоматическом отклонении приглашений.
end_timestring | null
Дата/время окончания (не включается в диапазон). Формат тот же, что и у start_time. Например, для одного полного дня 5 апреля укажите start_time='2026-04-05' и end_time='2026-04-06'. Обязательно для создания.
event_idstring | null
Event ID. Требуется для действий «update» и «delete».
max_resultsinteger
Для действия 'list': максимальное количество возвращаемых событий. По умолчанию — 10.
recurrencestring[] | null
Правила повторения RFC5545 для повторяющейся серии Out of Office, например ["RRULE:FREQ=WEEKLY;COUNT=10"].
start_timestring | null
Начальная дата/время. Используйте 'YYYY-MM-DD' для полного дня или RFC3339 для частичного дня (например, '2024-04-05T09:00:00Z'). Значения только с датой автоматически преобразуются в dateTime (от полуночи до полуночи). Обязательно для создания.
summarystring | null
Текст для отображения в календаре. По умолчанию: "Out of Office".
time_maxstring | null
Для действия 'list': конец временного диапазона.
time_minstring | null
Для действия «list»: начало временного диапазона. По умолчанию — текущее время. Повторяющиеся серии разворачиваются в отдельные экземпляры в запрошенном диапазоне.
timezonestring | null
Часовой пояс для события (например, "America/New_York", "Europe/London"). Обязателен при использовании значений только с датой или значений даты и времени без явного смещения UTC.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

manage_presentation_commentвнешний мир

Управляет комментариями в Google Презентации. Действия: - create: Создаёт новый комментарий. Требует comment_content. Примечание: API Drive не может привязывать комментарии к произвольному тексту; через API комментарии в Презентациях прикрепляются к элементам. - reply: Отвечает на комментарий. Требует comment_id и comment_content. - resolve: Закрывает комментарий. Требует comment_id.

Управление комментарием презентации

Параметры

actionstringобязательный
comment_contentstring | null
comment_idstring | null
presentation_idstringобязательный
user_google_emailstringобязательный

manage_sheet_tabвнешний мир

Управляет жизненным циклом существующей вкладки листа: переименовать, удалить, скрыть, показать или изменить порядок. Используйте create_sheet, чтобы добавить вкладку, и resize_sheet_dimensions для изменений на уровне строк и столбцов. Этот инструмент работает с самой вкладкой.

Управление вкладкой листа

Параметры

actionstringобязательный
Одно из "rename", "delete", "hide", "unhide", "reorder"
new_indexinteger | null
Новая позиция с отсчётом от нуля, обязательна для action="reorder"
new_namestring | null
Новое название, требуется для action="rename"
sheet_namestringобязательный
Заголовок существующей вкладки, над которой нужно выполнить действие
spreadsheet_idstringобязательный
ID электронной таблицы
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

manage_spreadsheet_commentвнешний мир

Управление комментариями в Google Таблице. Действия: - create: Создать новый комментарий. Требуется comment_content. Примечание: Drive API не может привязывать комментарии к произвольному тексту; комментарии в Таблицах привязаны к ячейкам через API. - reply: Ответить на комментарий. Требуются comment_id и comment_content. - resolve: Закрыть комментарий. Требуется comment_id.

Управление комментарием в электронной таблице

Параметры

actionstringобязательный
comment_contentstring | null
comment_idstring | null
spreadsheet_idstringобязательный
user_google_emailstringобязательный

manage_taskвнешний мир

Управляет задачами: создаёт, обновляет, удаляет или перемещает задачи в списках задач.

Управлять задачей

Параметры

actionstringобязательный
Выполняемое действие. Должно быть одним из: "create", "update", "delete", "move".
destination_task_liststring | null
ID целевого списка задач (для перемещения между списками). Используется действием «move».
duestring | null
Срок выполнения в формате RFC 3339 (например, "2024-12-31T23:59:59Z"). Используется действиями "create" и "update".
notesstring | null
Заметки/описание для задачи. Используется в действиях «создание» и «обновление».
parentstring | null
ID родительской задачи (для подзадач). Используется действиями «create» и «move».
previousstring | null
Идентификатор предыдущей задачи того же уровня (для позиционирования). Используется действиями "create" и "move".
statusstring | null
Статус задачи ("needsAction" или "completed"). Используется действием "update".
task_idstring | null
ID задачи. Требуется для действий «обновление», «удаление» и «перемещение».
task_list_idstringобязательный
Идентификатор списка задач. Требуется для всех действий.
titlestring | null
Название задачи. Обязательно для «create», необязательно для «update».
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

manage_task_listвнешний мир

Управляет списками задач: создаёт, обновляет, удаляет или очищает выполненные задачи.

Управление списком задач

Параметры

actionstringобязательный
Действие, которое нужно выполнить. Должно быть одним из: "create", "update", "delete", "clear_completed".
task_list_idstring | null
Идентификатор списка задач. Требуется для действий "update", "delete" и "clear_completed".
titlestring | null
Заголовок для списка задач. Обязателен для действий «create» и «update».
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

modify_doc_textвнешний мир

Изменяет текст в Google Doc - может вставлять или заменять текст и/или применять форматирование одной операцией. СОВЕТ: Чтобы добавить текст в конец документа без вычисления индексов, установите end_of_segment=true. Это позволяет избежать ошибок при вычислении индексов. Для обычного текста верхнего/нижнего колонтитула используйте update_doc_headers_footers. Передавайте segment_id только если у вас уже есть реальный идентификатор сегмента верхнего/нижнего колонтитула или сноски из вывода inspect_doc_structure. Не угадывайте идентификаторы вроде "kix.header" или "kix.footer".

Изменяет текст документа

Параметры

background_colorstring
Цвет фона/выделения (#RRGGBB)
baseline_offsetstring
Одно из: NONE, SUPERSCRIPT, SUBSCRIPT
boldboolean
Нужно ли делать текст жирным (True/False/None, чтобы оставить без изменений)
clear_linkboolean
Удалить гиперссылку из целевого диапазона
document_idstringобязательный
Идентификатор документа для обновления.
end_indexinteger
Конечная позиция для замены/форматирования текста (если текст не указан, текст вставляется)
end_of_segmentboolean
Вставьте текст в конец целевого сегмента вместо start_index.
font_familystring
Название семейства шрифта (например, «Arial», «Times New Roman»)
font_sizenumber
Размер шрифта в пунктах.
font_weightinteger
Насыщенность шрифта (100–900 с шагом 100; требуется font_family)
italicboolean
Следует ли делать текст курсивным (True/False/None, чтобы оставить без изменений)
link_urlstring
Гиперссылка URL (http/https)
segment_idstring
Необязательный идентификатор сегмента верхнего/нижнего колонтитула/сноски для нацеливания.
small_capsboolean
Применять капитель
start_indexintegerобязательный
Начальная позиция для операции с использованием индексов Docs API из inspect_doc_structure. Для основного тела документа также принимается 0 как псевдоним первой позиции для записи.
strikethroughboolean
Следует ли зачеркивать текст (True/False/None, чтобы оставить без изменений).
tab_idstring
Необязательный идентификатор вкладки документа для указания.
textstring
Новый текст для вставки или замены (необязательно - можно форматировать существующий текст, не изменяя его).
text_colorstring
Цвет текста переднего плана (#RRGGBB)
underlineboolean
Подчеркивать ли текст (True/False/None, чтобы оставить без изменений)
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

modify_gmail_message_labelsвнешний мир

Добавляет или удаляет метки из письма Gmail. Чтобы заархивировать письмо, удалите метку INBOX. Чтобы удалить письмо, добавьте метку TRASH.

Изменить метки сообщений Gmail

Параметры

add_label_idsstring[]
Список ID меток для добавления в сообщение.
message_idstringобязательный
Идентификатор сообщения для изменения.
remove_label_idsstring[]
Какие идентификаторы меток нужно удалить из сообщения.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

modify_sheet_valuesвнешний мир

Изменяет значения в определённом диапазоне Google Sheet - может записывать, обновлять или очищать значения.

Изменить значения листа

Параметры

clear_valuesboolean
Если True, очищает диапазон вместо записи значений. По умолчанию: False.
range_namestringобязательный
Диапазон для изменения (например, "Sheet1!A1:D10", "A1:D10"). Обязательный параметр.
spreadsheet_idstringобязательный
Идентификатор электронной таблицы. Обязателен.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.
value_input_optionstring
Как интерпретировать входные значения ("RAW" или "USER_ENTERED"). По умолчанию используется "USER_ENTERED".
valuesstring | string[][] | null
Двумерный массив значений для записи/обновления. Может быть JSON-строкой или списком Python. Обязателен, если только clear_values=True.

move_sheet_rowsвнешний мир

Перемещает строки с одного листа на другой в пределах одной таблицы. Перемещение выполняется одной операцией batchUpdate (сначала copyPaste, затем deleteDimension). Важно: batchUpdate выполняет запросы последовательно, но не откатывает частичный сбой — если копирование прошло успешно, а удаление нет, строки могут дублироваться. Формулы, типы данных и форматирование сохраняются (в отличие от обхода через values.get/append). Номера строк начинаются с 1 (как в интерфейсе таблицы).

Переместить строки листа

Параметры

destination_sheetstringобязательный
Название листа, куда перемещаются строки. Обязательно.
end_rowintegerобязательный
Последняя строка для перемещения (счёт с 1, включительно). Обязательно.
source_sheetstringобязательный
Название листа, из которого перемещаются строки. Обязательно.
spreadsheet_idstringобязательный
Идентификатор электронной таблицы. Обязателен.
start_rowintegerобязательный
Первая строка для перемещения (с отсчётом от 1, включительно). Обязательно.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

query_freebusyтолько чтениеидемпотентныйвнешний мир

Возвращает информацию о свободном/занятом времени для набора календарей.

Запрашивает информацию Freebusy.

Параметры

calendar_expansion_maxinteger | null
Максимальное количество календарей, для которых должна быть предоставлена информация о занятости. Необязательно. Максимальное значение: 50.
calendar_idsstring[] | null
Список идентификаторов календарей для запроса. Если не указан, запрашивается основной календарь. Используйте primary для основного календаря пользователя или конкретные идентификаторы календарей, полученные из list_calendars.
group_expansion_maxinteger | null
Максимальное количество идентификаторов календарей для одной группы. Необязательно. Если в группе больше участников, чем это значение, возвращается ошибка. Максимальное значение: 100.
time_maxstringобязательный
Конец интервала для запроса в формате RFC3339 (например, '2024-05-12T18:00:00Z' или '2024-05-12').
time_minstringобязательный
Начало интервала для запроса в формате RFC3339 (например, '2024-05-12T10:00:00Z' или '2024-05-12').
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

read_sheet_valuesтолько чтениеидемпотентныйвнешний мир

Читает значения из заданного диапазона в Google Таблице.

Read Sheet Values

Параметры

include_formulasboolean
Если значение равно True, также извлекаются необработанные строки формул для ячеек, содержащих формулы. Это полезно для выявления межлистовых ссылок перед записью обратно в диапазон. По умолчанию используется значение False, чтобы избежать дополнительного API-запроса.
include_hyperlinksboolean
Если задано True, также извлекает метаданные гиперссылок для диапазона. По умолчанию используется False, чтобы избежать дорогостоящих запросов includeGridData.
include_notesboolean
Если значение True, также извлекает примечания к ячейкам для диапазона. По умолчанию используется False, чтобы избежать дорогостоящих запросов includeGridData.
range_namestring
Диапазон для чтения (например, "Sheet1!A1:D10", "A1:D10"). По умолчанию используется "A1:Z1000". Открытые или слишком большие диапазоны ограничиваются максимум 1000 строками перед запросом к Sheets API, чтобы ограничить использование памяти.
spreadsheet_idstringобязательный
Идентификатор электронной таблицы. Обязателен.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

resize_sheet_dimensionsвнешний мир

Управляет свойствами размеров на уровне листа: изменение размера столбцов/строк, автоматическое изменение размера по содержимому, закрепление строк/столбцов, скрытие/отображение строк/столбцов и вставка/удаление строк/столбцов.

Изменить размеры листа

Параметры

auto_resize_columnsstring | string[] | null
Список букв столбцов для автоматического изменения размера под содержимое. Пример: ["A", "B"].
auto_resize_rowsstring | integer[] | null
Список номеров строк (начиная с 1) для автоматического изменения размера под содержимое. Пример: [1, 2].
column_sizesstring | object | null
Словарь, сопоставляющий буквы столбцов с шириной в пикселях. Пример: {"A": 200, "C": 300}. Может быть JSON-строкой или Python-словарем.
delete_columnsstring | string[] | null
Перечислите буквы столбцов, которые нужно удалить. Пример: ["E", "F"].
delete_row_rangestring | null
Непрерывный диапазон строк для удаления, в формате "start:end" (с 1 по N включительно). Например, "5:10" удаляет строки с 5 по 10. Эффективнее, чем delete_rows, для больших непрерывных диапазонов.
delete_rowsstring | integer[] | null
Список номеров строк с отсчётом от 1 для удаления. Пример: [5, 6]. Лучше всего подходит для несмежных строк.
frozen_column_countinteger | null
Сколько столбцов закрепить слева. Укажите 0, чтобы снять закрепление со всех столбцов.
frozen_row_countinteger | null
Количество строк для закрепления сверху. Используйте 0, чтобы открепить все строки.
hide_columnsstring | string[] | null
Список букв столбцов для скрытия. Пример: ["C", "D"].
hide_rowsstring | integer[] | null
Список номеров строк для скрытия, нумерация начинается с 1. Пример: [3, 4].
insert_columnsinteger | null
Количество столбцов для вставки.
insert_columns_atstring | null
Буква столбца для вставки перед (например, "C"). Если не указано, добавляется в конец.
insert_rowsinteger | null
Количество строк для вставки.
insert_rows_atinteger | null
Номер строки (отсчет от 1) для вставки перед ней. Если не указано, добавляет в конец листа.
row_sizesstring | object | null
Словарь, сопоставляющий номера строк (начиная с 1) с высотами в пикселях. Пример: {"1": 40, "3": 60}. Может быть JSON-строкой или словарём Python.
sheet_namestring | null
Имя целевого листа. Если не указано, по умолчанию используется первый лист.
spreadsheet_idstringобязательный
Идентификатор электронной таблицы. Обязателен.
unhide_columnsstring | string[] | null
Список букв столбцов для отображения. Пример: ["C", "D"].
unhide_rowsstring | integer[] | null
Список номеров строк с отсчетом от 1 для отображения. Пример: [3, 4].
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

run_script_functionвнешний мир

Выполняет функцию в развернутом скрипте.

Выполняет функцию скрипта.

Параметры

dev_modeboolean
Запускать ли последний код или развернутую версию
function_namestringобязательный
Имя функции для выполнения
parametersany[] | null
Необязательный список параметров для передачи.
script_idstringобязательный
Идентификатор проекта скрипта.
user_google_emailstringобязательный
Адрес электронной почты пользователя

search_contactsтолько чтениеидемпотентныйвнешний мир

Ищет контакты по имени, email, номеру телефона или другим полям.

Поиск контактов

Параметры

page_sizeinteger
Максимальное количество возвращаемых результатов (по умолчанию: 30, максимум: 30).
querystringобязательный
Строка поискового запроса (ищет по именам, адресам электронной почты, номерам телефонов).
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

search_customтолько чтениеидемпотентныйвнешний мир

Выполняет поиск с помощью Google Custom Search JSON API.

Search Custom

Параметры

countrystring | null
Код страны для результатов (например, "countryUS").
date_restrictstring | null
Ограничьте результаты по дате (например, "d5" — за последние 5 дней, "m3" — за последние 3 месяца).
file_typestring | null
Фильтровать по типу файла (например, "pdf", "doc").
languagestring | null
Код языка для результатов (например, «lang_en»).
numinteger
Количество возвращаемых результатов (1-10). По умолчанию 10.
qstringобязательный
Поисковый запрос. Обязательно.
safeenum
Уровень безопасного поиска. По умолчанию — "off".
search_typestring | null
Ищет изображения, если установлено значение "image".
sitesstring[] | null
Список сайтов/доменов для ограничения поиска (например, ["example.com", "docs.example.com"]). Если указано, результаты ограничиваются этими сайтами.
site_searchstring | null
Ограничьте поиск конкретным сайтом/доменом.
site_search_filterenum | null
Исключить ("e") или включить ("i") результаты site_search.
startinteger
Индекс первого возвращаемого результата (начиная с 1). По умолчанию — 1.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

search_docsтолько чтениеидемпотентныйвнешний мир

Ищет Google Docs по имени через Drive API (фильтр mimeType). Возвращает: str: Отформатированный список Google Docs, соответствующих поисковому запросу.

Search Docs

Параметры

page_sizeinteger
querystringобязательный
user_google_emailstringобязательный

search_drive_filesтолько чтениеидемпотентныйвнешний мир

Ищет файлы и папки в Google Диске пользователя, включая общие диски.

Ищет файлы Drive

Параметры

corporastring | null
Тела элементов для запроса (например, 'user', 'domain', 'drive', 'allDrives'). Если указан 'drive_id', а 'corpora' равно None, по умолчанию используется 'drive'. В противном случае применяется стандартное поведение Drive API. Для эффективности предпочтительнее использовать 'user' или 'drive' вместо 'allDrives'.
detailedboolean
Определяет, включать ли размер, время изменения и ссылку в результаты. По умолчанию — True.
drive_idstring | null
Идентификатор общего диска для поиска. Если указано None, поведение зависит от corpora и include_items_from_all_drives.
file_typestring | null
Ограничивает результаты по конкретному типу файла. Принимает понятное название ('folder', 'document'/'doc', 'spreadsheet'/'sheet', 'presentation'/'slides', 'form', 'drawing', 'pdf', 'shortcut', 'script', 'site', 'jam'/'jamboard') или любую строку с сырым MIME-типом (например, 'application/pdf'). По умолчанию — None (все типы).
include_items_from_all_drivesboolean
Следует ли включать элементы общих дисков в результаты. По умолчанию — True. Это действует, когда не указан drive_id.
include_trashedboolean
Включает ли файлы в корзину. По умолчанию — False, что соответствует веб-интерфейсу Drive и list_drive_items. Игнорируется, когда query уже содержит собственное условие trashed (= или !=), которое всегда имеет приоритет.
order_bystring | null
Порядок сортировки. Список ключей сортировки через запятую с необязательным модификатором 'desc'. Допустимые ключи: 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', 'viewedByMeTime'. Пример: 'modifiedTime desc' или 'folder,modifiedTime desc,name'. По умолчанию — None (стандартный порядок сортировки Drive API).
page_sizeinteger
Максимальное количество файлов для возврата. По умолчанию — 10.
page_tokenstring | null
Токен страницы из nextPageToken предыдущего ответа для получения следующей страницы результатов.
querystringобязательный
Строка поискового запроса. Поддерживает операторы поиска Google Drive. ПРИМЕЧАНИЕ: Запросы на основе владельца ('user@example.com' в owners) НЕ РАБОТАЮТ в общих дисках, потому что файлы принадлежат самому общему диску, а не отдельным пользователям. Для поиска недавних файлов конкретного пользователя в общих дисках ищите по modifiedTime и используйте order_by='modifiedTime desc'.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

search_gmail_messagesтолько чтениеидемпотентныйвнешний мир

Ищет сообщения в учётной записи Gmail пользователя по запросу. Возвращает как идентификаторы сообщений (Message IDs), так и идентификаторы цепочек (Thread IDs) для каждого найденного сообщения, вместе со ссылками на веб-интерфейс Gmail для ручной проверки. Поддерживает постраничную навигацию с помощью параметра page_token.

Ищет сообщения Gmail

Параметры

include_headersboolean
Если True, дополнительно подтягивает метаданные каждого сообщения и включает Subject, From и Date в каждый результат. Стоит одно получение метаданных на результат, сгруппированных в HTTP-пакеты до 10, плюс повторные попытки при временных сбоях. По умолчанию False (вывод не меняется по сравнению с предыдущими версиями).
page_sizeinteger
Максимальное количество возвращаемых сообщений. По умолчанию — 10.
page_tokenstring | null
Токен для получения следующей страницы результатов. Используйте next_page_token из предыдущего ответа.
querystringобязательный
Поисковый запрос. Поддерживает стандартные операторы поиска Gmail.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

search_messagesтолько чтениеидемпотентныйвнешний мир

Ищет сообщения в пространствах Google Chat по текстовому содержимому и/или временному диапазону.

Поиск сообщений

Параметры

max_spacesinteger
Максимальное количество пространств для поиска, когда space_id не указан (по умолчанию 10).
page_sizeinteger
Максимальное количество сообщений, возвращаемых на пространство.
querystring | null
Необязательный текст для поиска. Если параметр опущен, применяется только time_filter.
space_idstring | null
Необязательное поле для ограничения поиска.
time_filterstring | null
Необязательный фильтр с использованием синтаксиса createTime в Chat API. Примеры: 'createTime > "2026-03-18T00:00:00-03:00"' 'createTime > "2026-03-18T00:00:00-03:00" AND createTime < "2026-03-19T00:00:00-03:00"'
user_google_emailstringобязательный

send_gmail_messageвнешний мир

Отправляет электронное письмо через аккаунт Gmail пользователя. Поддерживает новые письма, ответы и пересылки, с необязательными вложениями. Поддерживает функцию Gmail "Send As" для отправки с настроенных адресов-алиасов. Чтобы переслать существующее сообщение, передайте forward_message_id. Исходная тема, тело (процитированное с заголовком "Forwarded message") и вложения переносятся. В режиме пересылки тело (если есть) добавляется в начало как примечание, а тема необязательна. Параметры ветки обсуждения, ответа и подписи не применяются при пересылке. ЭТОТ ИНСТРУМЕНТ ОТПРАВЛЯЕТ НЕМЕДЛЕННО И НЕ МОЖЕТ ПЛАНИРОВАТЬ. REST API Gmail не предоставляет параметр времени отправки; отложенная отправка - это функция веб-интерфейса без эквивалента в API, поэтому ни один аргумент этого инструмента не может отложить доставку. Никогда не говорите пользователю, что сообщение было запланировано. Для сценария «подготовить сейчас, доставить позже» создайте черновик с помощью draft_gmail_message. Внешний планировщик должен хранить данные сообщения, чтобы создать и отправить новое сообщение через send_gmail_message в выбранное время, или вызвать users.drafts.send с идентификатором черновика, возвращённым draft_gmail_message. Альтернативно, позвольте пользователю запланировать этот черновик в интерфейсе Gmail.

Отправить сообщение Gmail

Параметры

attachmentsobject[] | null
Необязательный список вложений. Каждый элемент может содержать: "url" (загрузить по URL — работает с URL вложений MCP из get_drive_file_download_url / get_gmail_attachment_content), ИЛИ "path" (путь к файлу, автоматически кодируется), ИЛИ "content" (стандартный base64, не urlsafe) + "filename". Необязательный "mime_type". Необязательный "content_id" (строка) делает вложение встроенным: оно попадает в часть multipart/related с Content-ID: <content_id> и Content-Disposition: inline, и HTML-тело может ссылаться на него через <img src="cid:<content_id>"> (RFC 2392). Без content_id вложение является обычным вложением multipart/mixed. Пример: [{"url": "https://host/attachments/abc-123", "filename": "report.pdf"}]
bccstring | null
Необязательный адрес электронной почты для скрытой копии.
bodystring | null
Содержимое тела письма (обычный текст или HTML). Обязательно при отправке. При пересылке это необязательная заметка, добавляемая над цитируемым оригиналом.
body_formatenum
Формат содержимого тела (и добавленной заметки при пересылке). Используйте 'plain' для обычного текста или 'html' для HTML-содержимого.
ccstring | null
Необязательный адрес электронной почты для копии.
forward_message_idstring | null
Установите идентификатор сообщения Gmail, чтобы переслать это сообщение вместо создания нового. Исходные тема, тело и (при необходимости) вложения переносятся; 'body' становится необязательной заметкой, добавляемой в начало пересылаемого сообщения.
from_emailstring | null
Опциональный адрес электронной почты для псевдонима "Send As". Должен быть настроен в настройках Gmail (Настройки > Аккаунты > Отправлять письма как). Если не указан, используется email аутентифицированного пользователя.
from_namestring | null
Необязательное отображаемое имя отправителя (например, 'Peter Hartree'). Если оно указано, заголовок From будет отформатирован как 'Name <email>'.
include_forwarded_attachmentsboolean
При пересылке определяет, нужно ли включать вложения из исходного сообщения. Игнорируется, если не задан forward_message_id.
include_signatureboolean
Определяет, следует ли добавлять подпись Gmail из раздела «Настройки» > «Подпись», если она доступна. По умолчанию — true.
in_reply_tostring | null
Необязательный RFC Message-ID для явного ответа на конкретное сообщение (например, 'message123@gmail.com'). Опустите, чтобы ответить на последнее подходящее сообщение в thread_id.
quote_originalboolean
Определяет, нужно ли включать исходное сообщение, на которое даётся ответ, в качестве цитаты. Параметр действует только при указанном thread_id. По умолчанию — false.
referencesstring | null
Необязательная цепочка предков Message-ID. Обычно опускается, когда указан thread_id; сервер выводит цепочку через выбранную цель ответа.
reply_allboolean
Определяет, нужно ли выводить получателей для ответа всем из ветки обсуждения: To = отправитель, на которого отвечают, Cc = остальные участники, исключая аутентифицированную учетную запись и from_email. Требуется thread_id. Явные значения to/cc имеют приоритет; когда cc опущено, отправитель, на которого отвечают, добавляется в выведенный Cc, если его еще нет в To. По умолчанию: false.
subjectstring | null
Тема письма. Обязательна при отправке; необязательна при пересылке (по умолчанию — 'Fwd: <исходная тема>').
thread_idstring | null
Необязательный ID ветки Gmail, в которой нужно ответить. Когда параметр in_reply_to опущен, ответ отправляется на последнее сообщение, не являющееся черновиком и не находящееся в корзине, с RFC-идентификатором сообщения.
tostring | null
Адрес электронной почты получателя. Необязателен при ответе с reply_all=True, который берёт его из ветки обсуждения.
user_google_emailstringобязательный
Адрес Gmail пользователя. Требуется для аутентификации.

send_messageвнешний мир

Отправляет сообщение в пространство Google Chat или редактирует уже отправленное туда сообщение.

Отправить сообщение

Параметры

message_namestring | null
Редактирует это сообщение на месте, а не отправляет новое (например, spaces/X/messages/Y, как возвращают send_message или get_messages). Сообщение должно принадлежать пространству space_id. Заменяется только текст, и только автор может редактировать своё сообщение.
message_textstringобязательный
space_idstringобязательный
thread_keystring | null
Отвечает в ветке по ключу, заданному приложением (создаёт ветку, если она не найдена).
thread_namestring | null
Отвечает в существующем треде по имени ресурса (например, spaces/X/threads/Y).
user_google_emailstringобязательный

set_drive_file_permissionsвнешний мир

Устанавливает настройки общего доступа на уровне файла и управляет ссылками для общего доступа к файлу или папке Google Drive. Это высокоуровневый инструмент для самых частых изменений разрешений. Используйте его, чтобы включить или отключить доступ "для всех у кого есть ссылка" или настроить поведение общего доступа на уровне файла. Для управления разрешениями отдельных пользователей или групп используйте share_drive_file или update_drive_permission.

Установить разрешения для файлов Drive

Параметры

copy_requires_writer_permissionboolean | null
Определяет, запрещено ли зрителям и комментаторам копирование, печать или скачивание. По умолчанию — нет (без изменений).
file_idstringобязательный
Идентификатор файла или папки. Обязательно.
link_sharingstring | null
Управление доступом к файлу для "всех, у кого есть ссылка". - "off": Отключить доступ "для всех, у кого есть ссылка" к этому файлу. - "reader": Все, у кого есть ссылка, могут просматривать. - "commenter": Все, у кого есть ссылка, могут оставлять комментарии. - "writer": Все, у кого есть ссылка, могут редактировать.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.
writers_can_shareboolean | null
Редакторы могут изменять разрешения и предоставлять доступ. Если значение False, только владелец может предоставлять доступ. По умолчанию — None (без изменений).

set_publish_settingsвнешний мир

Обновляет настройки публикации формы.

Set Publish Settings

Параметры

form_idstringобязательный
Идентификатор формы, для которой нужно обновить настройки публикации.
is_accepting_responsesboolean
Определяет, принимает ли форма ответы. Действует только когда форма опубликована. По умолчанию — True.
is_publishedboolean
Определяет, опубликована ли форма и видна ли она респондентам. По умолчанию - True.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.

start_google_authвнешний мир

Запускает вручную процесс аутентификации Google OAuth. ПРИМЕЧАНИЕ: Это устаревший инструмент OAuth 2.0, отключенный при включенном OAuth 2.1. Система аутентификации автоматически обрабатывает проверку учетных данных и запрашивает аутентификацию при необходимости. Используйте этот инструмент только если: 1. Требуется повторная аутентификация с другими учетными данными 2. Вы хотите выполнить аутентификацию заранее перед использованием других инструментов 3. Автоматический поток аутентификации завершился ошибкой и требуется повторная попытка В большинстве случаев достаточно просто вызвать нужный инструмент Google Workspace. Он автоматически обработает аутентификацию, если потребуется.

Запускает Google Auth.

Параметры

service_namestringобязательный
user_google_emailstring

update_doc_headers_footersвнешний мир

Безопасно создаёт или обновляет текст верхнего/нижнего колонтитула в Google Doc. Это инструмент по умолчанию для содержимого колонтитулов. НЕ используйте batch_update_doc с create_header_footer только для установки текста колонтитула; эта низкоуровневая операция предназначена исключительно для продвинутых сценариев с разрывами разделов и может завершиться ошибкой, если колонтитул по умолчанию уже существует. Этот инструмент выполняет и создание, и обновление за один вызов: - Если колонтитула нет, он сначала автоматически создаётся. - Если колонтитул уже существует, его содержимое заменяется. Вам НЕ нужно создавать колонтитул отдельно перед вызовом этого инструмента. Просто вызовите его с нужным содержимым — он сработает независимо от того, существует колонтитул или нет.

Обновляет заголовки и нижние колонтитулы документа

Параметры

contentstringобязательный
Текстовое содержимое для шапки/подвала
document_idstringобязательный
Идентификатор документа для обновления.
header_footer_typestring
Тип верхнего/нижнего колонтитула («DEFAULT», «FIRST_PAGE_ONLY», «EVEN_PAGE»)
section_typestringобязательный
Тип раздела для создания или обновления («header» или «footer»)
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

update_drive_fileвнешний мир

Обновляет метаданные, свойства и/или содержимое файла Google Drive. Если передать один из параметров content, file_path или file_url, содержимое файла заменяется на месте, при этом сохраняются существующий идентификатор файла, общий доступ, комментарии и ссылки. Для нативных документов Google Docs/Sheets/Slides исходный файл загружается со своим исходным MIME-типом, поэтому Drive API применяет то же преобразование формата, что и import_to_google_doc (заголовки Markdown, таблицы, жирный шрифт и т.д.). Для любых других файлов (.md, .txt, .pdf, ...) преобразовывать нечего, поэтому байты записываются как есть, под собственным MIME-типом файла. Метаданные и содержимое можно обновить одним вызовом. Режимы mode='append'/'prepend' добавляют content к существующему тексту файла на стороне сервера, поэтому нужно передать только новый текст: нет необходимости отправлять весь файл обратно для перезаписи. Ярлыки Drive обрабатываются в зависимости от типа обновления: поддерживаемые изменения метаданных, локальных для ресурса (переименование, перемещение, удаление в корзину, отметка звездой, описание и пользовательские свойства), применяются к переданному ярлыку, а замена содержимого следует за ярлыком и обновляет его целевой объект. Чтобы не применить метаданные к неправильному ресурсу, вызов ярлыка не может сочетать содержимое с локальными для ресурса метаданными. Обновляйте метаданные ярлыка и целевое содержимое отдельными вызовами.

Обновляет Drive File

Параметры

add_parentsstring | null
Идентификаторы папок через запятую для добавления в качестве родительских.
contentstring | null
Новое текстовое содержимое для текстовых форматов (markdown, TXT, HTML).
copy_requires_writer_permissionboolean | null
Указывает, требуется ли для копирования разрешение на запись. Передавайте целевой ID напрямую; это значение нельзя изменить для ресурса-ярлыка.
descriptionstring | null
Новое описание для файла.
file_idstringобязательный
ID файла для обновления. Обязательно.
file_pathstring | null
Локальный путь к файлу для бинарных форматов (DOCX, ODT). Поддерживает URL вида file://.
file_urlstring | null
Удаленный URL-адрес http(s) для получения нового контента.
mime_typestring | null
Новый тип MIME (примечание: изменение типа может потребовать загрузки контента). Для идентификатора ярлыка это должно сопровождать контент и применяться к разрешенной цели.
modestring
Как применить новый контент - 'replace' (по умолчанию), 'append' или 'prepend'. Append/prepend требуют 'content' и текстовый файл в кодировке UTF-8, такой как .md или .txt; перевод строки вставляется в месте соединения, если ни одна из сторон не имеет его. Для нативных Google Docs используйте insert_doc_elements, modify_doc_text или find_and_replace_doc, которые редактируют на месте вместо перезаписи файла.
namestring | null
Новое имя для файла.
propertiesobject | null
Пользовательские свойства «ключ-значение» для файла.
remove_parentsstring | null
Идентификаторы папок, разделенные запятыми, для удаления из родительских папок.
source_formatstring | null
Подсказка формата исходного файла для конвертации (md, markdown, docx, txt, html, rtf, odt). Если не указано, формат определяется автоматически. Для файлов, не относящихся к Google, параметр игнорируется: такие файлы загружаются без конвертации. Укажите не более одного из параметров: content, file_path или file_url.
starredboolean | null
Стоит ли ставить или убирать звезду у файла?
trashedboolean | null
Нужно ли перемещать файл в корзину или из корзины.
user_google_emailstringобязательный
Адрес электронной почты Google пользователя. Обязательно.
writers_can_shareboolean | null
Определяет, могут ли редакторы делиться файлом. Передавайте целевой идентификатор напрямую; для ресурса-ярлыка это значение изменить нельзя.

update_paragraph_styleвнешний мир

Применяет форматирование на уровне абзаца, стили заголовков и/или форматирование списков к диапазону в Google Doc. Этот инструмент применяет именованные стили заголовков (H1-H6) для семантической структуры документа, создаёт маркированные или нумерованные списки с вложенными отступами и настраивает свойства абзаца, такие как выравнивание, интервалы и отступы. Все операции выполняются за один вызов.

Обновляет стиль абзаца

Параметры

alignmentstring
Выравнивание текста - 'START' (слева), 'CENTER', 'END' (справа) или 'JUSTIFIED'
avoid_widow_and_orphanboolean
Избегайте висячих строк в абзаце
border_colorstring
Цвет границы (#RRGGBB; по умолчанию: черный)
border_dashstring
Стиль линии границы ('SOLID', 'DOT' или 'DASH'; по умолчанию — 'SOLID')
border_edgesenum[]
Границы абзаца, которые нужно обновить ('верхняя', 'нижняя', 'левая', 'правая' или 'между'); если не указано, обновляются все четыре внешние границы
border_paddingnumber
Внутренний отступ границы в пунктах (по умолчанию 4)
border_widthnumber
Ширина границы в пунктах (по умолчанию — 1).
bullet_presetstring
Необязательный явный пресет маркеров Google Docs.
directionstring
Направление абзаца: 'LEFT_TO_RIGHT' или 'RIGHT_TO_LEFT'
document_idstringобязательный
ID документа для изменения
end_indexintegerобязательный
Конечная позиция (исключая) — должна охватывать весь абзац
heading_levelinteger
Уровень заголовка 0-6 (0 = NORMAL_TEXT, 1 = H1, 2 = H2 и т. д.) Используйте для семантической структуры документа.
indent_endnumber
Отступ справа/в конце в пунктах
indent_first_linenumber
Отступ первой строки в пунктах (например, 36 для 0,5 дюйма)
indent_startnumber
Отступ слева/в начале в пунктах
keep_lines_togetherboolean
Сохраняйте все строки абзаца вместе.
keep_with_nextboolean
Понял, добавляю правило: сохраняю структуру абзацев — не объединяю и не разбиваю их, переношу разбивку на абзацы из исходного текста в перевод без изменений.
line_spacingnumber
Множитель межстрочного интервала (1.0 = одинарный, 1.5 = полуторный, 2.0 = двойной)
list_nesting_levelinteger
Уровень вложенности для списков (от 0 до 8, где 0 — верхний уровень, по умолчанию — 0). Используйте более высокие значения для вложенных или с отступом элементов списка.
list_typestring
Создаёт список из существующих абзацев ('UNORDERED' для маркеров, 'ORDERED' для номеров, 'CHECKBOX' для чек-листов) или 'NONE' для удаления форматирования списка из диапазона. Значение 'NONE' используется, когда текст, вставленный после списка, унаследовал его маркеры: установка named_style_type или heading_level не очищает принадлежность к списку, только 'NONE' делает это.
named_style_typestring
Прямой именованный тип стиля — 'NORMAL_TEXT', 'TITLE', 'SUBTITLE', 'HEADING_1' – 'HEADING_6'. Взаимоисключающий с heading_level.
page_break_beforeboolean
Начните абзац на новой странице.
segment_idstring
Необязательный идентификатор сегмента верхнего/нижнего колонтитула/сноски для нацеливания.
shading_colorstring
Заливка абзаца / цвет фона (#RRGGBB)
space_abovenumber
Интервал перед абзацем в пунктах (например, 12 для одной строки)
space_belownumber
Интервал после абзаца в пунктах
spacing_modestring
'NEVER_COLLAPSE' или 'COLLAPSE_LISTS'
start_indexintegerобязательный
Начальная позиция с использованием индексов Docs API из inspect_doc_structure. Для основного текста 0 также принимается как псевдоним первой позиции для записи.
tab_idstring
Необязательный идентификатор вкладки документа для указания.
user_google_emailstringобязательный
Адрес электронной почты пользователя Google

update_script_contentвнешний мир

Обновляет или создаёт файлы в проекте скриптов.

Обновляет содержимое скрипта

Параметры

filesobject[]обязательный
Файловые объекты с именем, типом и источником для создания или обновления
mergeboolean
Когда True (по умолчанию), накладывает эти файлы на текущий проект. Когда False, заменяет полный набор файлов проекта; отсутствующие файлы удаляются.
script_idstringобязательный
Идентификатор проекта скрипта.
user_google_emailstringобязательный
Адрес электронной почты пользователя

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "workspace-mcp"
  ],
  "env": {
    "GOOGLE_OAUTH_CLIENT_ID": "your-client-id",
    "GOOGLE_OAUTH_CLIENT_SECRET": "your-secret",
    "OAUTHLIB_INSECURE_TRANSPORT": "1"
  }
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

FAQ

Для чего этот сервер?

Сервер даёт AI-агентам полный контроль над Google Workspace через обычный язык. Вместо того чтобы вручную копаться в Gmail, Календаре, Диске или Документах, можно просто сказать ассистенту, что нужно сделать — и он выполнит. Это единственный MCP-сервер, который охватывает все основные сервисы Google, включая Чаты, Формы и Apps Script, и при этом поддерживает многопользовательскую авторизацию и централизованный хостинг для всей организации.

Что он умеет?

Управляет Gmail: отправляет, читает, ищет письма и вложения, работает с черновиками, метками и фильтрами. Ведёт календарь: создаёт и меняет события, настраивает фокус-время и оффлайн-режим. Работает с Google Drive и Docs: создаёт, копирует, ищет файлы, редактирует текст и форматирование, импортирует и экспортирует. Управляет таблицами и презентациями: создаёт листы, слайды, обновляет данные. Общается в Google Chat, ведёт задачи, контакты и скрипты Apps Script.

Информация о сервере

Номер в рейтинге: #51
Звезд на Github: 3141
Форков на Github: 980
Загрузок: 1 302 967
Язык реализации: Python
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 10.09 в 21:48
Идентификатор: bkmiukLG0WW7jwbs
Категории: CMS, Автоматизация приложений, Агенты, Визуализация данных, Выполнение кода, Документация, ИИ и машинное обучение, Инструменты для разработчиков, Командная строка, Коммуникации, Облачное хранилище, Облачные платформы, Оркестрация агентов, Платформы данных, Поиск, Рабочее место и продуктивность, Социальные сети, Управление календарем, Управление проектами, Файловые системы, Электронная почта