littlebearapps/outlook-assistant

Перечисляет письма из общего почтового ящика, к которому у вошедшего пользователя есть доступ (только чтение). Возвращает постраничные сообщения из указанного sharedMailbox (или псевдонима email) и folder (по умолчанию inbox) с полями id/subject/from/receivedDateTime/preview — та же структура, что и в режиме списка search-emails. Требует, чтобы общий почтовый ящик был делегирован вошедшему пользователю в Exchange (настраивается администратором). Используйте outputVerbosity для управления количеством полей и count (по умолчанию 25, макс. 50) для размера страницы. Для полноценного поиска и фильтрации по общему почтовому ящику лучше использовать search-emails с путём к папке, ограниченной этим ящиком.

Помечает или снимает пометку с писем с помощью основных категорий (созданных через manage-category). action=set (по умолчанию) заменяет текущий набор категорий письма на переданный массив categories. action=add добавляет категории к уже имеющимся на письме. action=remove удаляет только указанные категории, оставляя остальные. Принимает либо messageId (одно письмо), либо messageIds (пакетно через Graph $batch). categories сопоставляются по отображаемому имени: имена должны уже существовать в основном списке (сначала создайте их через manage-category). Возвращает подтверждение по каждому письму.

Проверяет или извлекает вложения электронной почты. action=list (по умолчанию) возвращает метаданные всех вложений для messageId (id, name, contentType, size, isInline) — только для чтения. action=view возвращает встроенное содержимое для text/JSON/XML-вложений через attachmentId; бинарные типы требуют загрузки. action=download сохраняет вложение на диск в outputDir (по умолчанию системная временная директория, создаётся автоматически) и возвращает путь к сохранённому файлу. messageId обязателен для всех действий; attachmentId обязателен для view/download. Используйте outputVerbosity для управления количеством полей списка.

Управляет аутентификацией через Microsoft Graph API. Действие status (по умолчанию) возвращает текущее состояние авторизации и автоматически обновляет токен доступа, если он истёк, но refresh-токен ещё действителен (окно ~90 дней) — вызывайте его первым, чтобы проверить состояние перед другими инструментами. Действие authenticate запускает OAuth-процесс: с method: "device-code" (по умолчанию, работает без головы) возвращает код + URL, который пользователь должен открыть; с method: "browser" открывает локальный auth-сервер на :3333 (предварительно запустите npm run auth-server). Передайте force: true, чтобы переавторизоваться поверх существующей активной сессии. Действие device-code-complete завершает device-code-авторизацию после того, как пользователь ввёл код в браузере — вызывайте его, когда в браузере отобразится успешная авторизация. Действие about возвращает версию сервера, настроенную аудиторию, список областей и другие диагностические сведения. Токены сохраняются в ~/.outlook-assistant-tokens.json и переживают перезапуски сервера.

Создаёт новое событие календаря в календаре по умолчанию вошедшего пользователя. Возвращает созданное событие с его id, webLink и (если есть участники) автоматически сгенерированной ссылкой на онлайн-встречу - участники получают приглашения при сохранении. Время использует настроенный часовой пояс (по умолчанию Australia/Melbourne; переопределяется через OUTLOOK_DEFAULT_TIMEZONE); опустите суффикс Z, чтобы передать местное время. Используйте manage-event action=update для изменения события после создания или manage-event action=cancel/delete для его удаления.

Полный жизненный цикл черновика для рабочих процессов с проверкой перед отправкой (разрушительные: охватывает send и delete). action=create сохраняет новый черновик в папке Drafts и возвращает его id (используйте dryRun: true, чтобы просмотреть без сохранения; checkRecipients: true сначала запускает mail-tips). action=update обновляет существующий черновик по id (изменяются только переданные поля). action=send отправляет существующий черновик - разделяет лимит запросов с send-email. action=delete безвозвратно удаляет черновик. action=reply/reply-all создает черновик ответа из сообщения id (используйте comment, чтобы добавить текст в начало - взаимно исключает с body). action=forward создает черновик пересылки (требует id и to). Белый список получателей применяется к create/update/forward. Возвращает объект черновика для create/update/reply/forward; подтверждение статуса для send/delete.

Экспортирует письма в файловые форматы для архивации, криминалистики или программной обработки. target=message (по умолчанию) экспортирует одно письмо по id в savePath — поддерживает mime/eml/markdown/json/csv. target=messages пакетно экспортирует либо явный массив emailIds, либо письма, подходящие под searchQuery (или сокращение query) в outputDir — поддерживает markdown/json/csv. target=conversation экспортирует всю ветку по conversationId в outputDir (по умолчанию в хронологическом порядке; передайте order: "reverse" для сортировки от новых к старым) — поддерживает eml/mbox/markdown/json/html/csv. target=mime возвращает сырые байты MIME в формате RFC-822 для id (используйте headersOnly только для заголовков, base64 для кодированной передачи, maxSize для ограничения — по умолчанию 1 МБ). includeAttachments по умолчанию равен true для экспорта одного письма и false для пакетного. Поддерживаемые форматы зависят от цели — смотрите перечисление параметров.

Находит доступные для бронирования переговорные комнаты в организации пользователя через конечную точку Graph rooms (только чтение). Возвращает ресурсы комнат с полями displayName, emailAddress, building, floor, capacity и bookingType — подходит для передачи в create-event в качестве участников. Фильтрует по query (совпадение с именем/email), building, floor или минимальному capacity. Возвращает пустой список для личных аккаунтов (конечная точка rooms работает только в M365). Используйте outputVerbosity, чтобы управлять количеством полей.

Управление почтовыми папками (tool-level destructiveHint=true, потому что delete безвозвратно удаляет папку; list и stats — действия только для чтения, несмотря на аннотацию). action=list (по умолчанию) возвращает дерево папок с id/displayName/parentFolderId (включите includeItemCounts для непрочитанных/всего, includeChildren для иерархии). action=create создает новую папку внутри входящих (или внутри folder/folderId/folderName) и возвращает её id. action=move перемещает письма (массив emailIds) в targetFolder. action=stats возвращает счетчики (totalItemCount/unreadItemCount) — подходит для планирования пагинации; используйте с outputVerbosity чтобы уменьшить шум. action=delete безвозвратно удаляет папку и её содержимое — корзины нет.

Предварительная проверка получателя через Graph POST /me/getMailTips (только чтение; использует существующую область Mail.Read - без дополнительных разрешений). Возвращает подсказки по каждому получателю: автоматические ответы (отпуск), статус переполнения почтового ящика, пользовательские подсказки администратора, ограничения доставки, требования модерации, внешний или внутренний контекст, максимальный размер сообщения и количество участников группы (всего + внешние). Используйте перед send-email или draft action=create, чтобы выявить проблемы вроде автоматических ответов (OOO) или предупреждений о внешних получателях до отправки сообщения; send-email/draft принимают checkRecipients: true, чтобы вызывать это автоматически. Принимает строку с разделителями-запятыми или массив адресов; tipTypes фильтрует запрашиваемые подсказки (по умолчанию — все).

Выводит предстоящие события календаря для текущего пользователя (только чтение). Возвращает массив событий с полями id, subject, start/end, attendees, location, organiser и webLink. Используйте count (по умолчанию 10, максимум 50), чтобы управлять размером страницы; этот инструмент не фильтрует - для фильтрации запросов используйте Outlook UI или конкретные диапазоны дат через Graph. Время возвращается в настроенном часовом поясе (по умолчанию Australia/Melbourne; переопределяется через OUTLOOK_DEFAULT_TIMEZONE).

Читает или обновляет настройки на уровне почтового ящика (идемпотентно — безопасно повторять; set-операции работают как PATCH и сливаются с текущим состоянием). action=get (по умолчанию) возвращает настройки — используйте section для фильтрации (language, timeZone, workingHours, automaticRepliesSetting или all). action=set-auto-replies настраивает автоответ: enabled true/false, опционально startDateTime/endDateTime (ISO 8601) для запланированного режима, internalReplyMessage и (опционально) externalReplyMessage. action=set-working-hours обновляет расписание: startTime/endTime (HH:MM) и daysOfWeek (массив от monday до sunday). При set-действиях возвращает обновлённый объект настроек.

Управляет главным списком категорий пользователя (цветные метки, доступные в почте, календаре и контактах). action=list (по умолчанию) возвращает категории с id/displayName/color. action=create добавляет новую категорию — displayName обязателен, color опционален (preset0-preset24, например preset0=Red, preset7=Blue). action=update (псевдоним set — устарел) меняет имя/цвет по id. action=delete удаляет категорию — это НЕ снимает метки с уже помеченных сообщений; существующие сообщения сохраняют "осиротевшую" метку до ручной очистки. Используйте apply-category для маркировки/снятия меток с конкретных сообщений.

Полный CRUD над личными контактами Outlook текущего пользователя (деструктивная операция: включает действие delete). action=list (по умолчанию) возвращает контакты с пагинацией через skip/count (по умолчанию 50). action=search возвращает контакты, соответствующие query по имени или email (по умолчанию 25). action=get возвращает полную информацию о контакте по id. action=create добавляет новый контакт и возвращает его id. action=update обновляет переданные поля по id (изменяются только переданные поля). action=delete безвозвратно удаляет контакт по id. Используйте outputVerbosity (minimal/standard/full) на list/search, чтобы контролировать количество полей. Предпочитайте search-people для ранжирования по релевантности из разных источников (контакты + каталог + недавние сообщения) - этот инструмент ищет только по вашим личным контактам Outlook.

Управление существующим событием календаря (деструктивное: охватывает update/decline/cancel/delete — используйте dryRun, где поддерживается, для предварительного просмотра). action=update редактирует поля на месте через PATCH (subject, start, end, attendees, body, location, isOnlineMeeting, sensitivity, showAs, importance, categories, reminderMinutesBeforeStart) — изменяются только переданные поля; передайте dryRun: true для предварительного просмотра PATCH-нагрузки. action=decline отклоняет приглашение (опционально comment). action=cancel отменяет событие, которое вы организовали, и уведомляет участников. action=delete окончательно удаляет событие. Возвращает обновлённое событие при update; в остальных случаях — подтверждение статуса. Примечание: action accept отсутствует — принимайте приглашения в интерфейсе Outlook (глагол accept в Graph ненадёжен для событий).

Управляет переопределениями Фокусированного ящика — явными правилами, которые заставляют сообщения от указанного отправителя попадать в «Фокус» или «Другое» независимо от классификации ML.action=list (по умолчанию) возвращает существующие переопределения с id/отправителем/классификацией.action=set создаёт или обновляет переопределение для emailAddress (опционально name), направляя будущие письма в focused (по умолчанию) или other.action=delete удаляет переопределение для emailAddress.Примечание: это работает только для аккаунтов, у которых включен Фокусированный ящик — личные аккаунты Outlook.com без него возвращают пустой список.

CRUD правил входящей почты на стороне сервера (деструктивный: включает delete; поддерживает dryRun при создании/обновлении для предварительного просмотра). Правила выполняются на сервере Exchange независимо от того, какой клиент открыт. action=list (по умолчанию) возвращает правила с id/name/sequence — передайте includeDetails: true, чтобы развернуть условия/действия/исключения. action=create создаёт новое правило из параметров условий (12 поддерживаемых: fromAddresses, containsSubject, bodyContains, hasAttachments, importance, sentTo, sensitivity и т.д.), параметров действий (9 поддерживаемых: moveToFolder, forwardTo, redirectTo, assignCategories, markAsRead, delete и т.д.) и опциональных исключений except*. action=update исправляет указанные поля по ruleId. action=reorder меняет приоритет выполнения через sequence (меньше — раньше). action=delete удаляет правило. Список разрешённых получателей применяется для forwardTo/redirectTo. Действие permanentDelete намеренно пропущено (слишком опасно для использования AI — пользуйтесь интерфейсом Outlook). Применяются сессионные лимиты (OUTLOOK_MAX_MANAGE_RULES_PER_SESSION).

Читает одно письмо по идентификатору (только чтение). По умолчанию: возвращает полное тело сообщения (HTML по умолчанию преобразуется в текст), тему, from/to/cc, receivedDateTime, conversationId, метаданные вложений и webLink в формате Markdown. С параметром headersMode: true: вместо этого возвращает криминалистические заголовки RFC-822 (DKIM, SPF, DMARC, цепочку Received, Message-ID, Authentication-Results). Комбинируйте с importantOnly: true для подмножества, относящегося к безопасности, с groupByType: true для сгруппированного по категориям представления или с raw: true для JSON вместо Markdown. С параметром includeHeaders: true (не в режиме заголовков): добавляет основные заголовки вместе с телом. Используйте outputVerbosity (minimal/standard/full) для управления детализацией вывода.

Поиск, список, дельта-синхронизация или группировка писем по обсуждениям — шесть режимов, выбираемых параметрами (только чтение). Без параметров: выводит список последних писем в папке folder (по умолчанию inbox). С фильтрами query/from/to/subject/date: полноценный поиск (объединяется через OData filter). С kqlQuery: сырой язык ключевых запросов (Keyword Query Language) для расширенного поиска на стороне сервера. С deltaMode: true: возвращает текущее состояние плюс deltaToken; передайте токен обратно при следующем вызове, чтобы получить только инкрементальные изменения — идеально для мониторинга папки входящих. С groupByConversation: true: возвращает обсуждения (threads). С conversationId: возвращает все сообщения в одной ветке обсуждения. С internetMessageId: ищет письмо по его заголовку RFC Message-ID. Личные аккаунты Outlook.com имеют ограниченную поддержку $search — этот инструмент автоматически переключается на OData filters / boolean filters / последний список, но структурированные фильтры (from/subject/receivedAfter/hasAttachments/unreadOnly) дают более чистые результаты. По умолчанию возвращает постраничные сообщения с полями id/subject/from/receivedDateTime/preview; используйте outputVerbosity для расширенного вывода.

Поиск с сортировкой по релевантности в личных контактах, справочнике организации и недавних сообщениях через Microsoft Graph People API (только чтение). Возвращает объекты people с полями displayName, emailAddresses, companyName, jobTitle и метаданными релевантности: подходит для запросов вида "кто такой X?" или "кому написать о Y?". Используйте manage-contact с action=search, когда вам нужны записи только из вашего личного хранилища контактов.

Составляет и отправляет письмо немедленно (деструктивно: отправляет внешние коммуникации). Возвращает подтверждение с идентификатором сохранённого сообщения. Контроль безопасности: dryRun: true — возвращает готовое письмо для проверки без отправки; checkRecipients: true — сначала запускает get-mail-tips, чтобы отметить получателей с автоответом / переполненным ящиком / ограничением доставки / внешних получателей; комбинируйте оба флага для полной проверки перед отправкой. Подчиняется лимитам сессии (OUTLOOK_MAX_EMAILS_PER_SESSION) и белому списку получателей (OUTLOOK_ALLOWED_RECIPIENTS) — вызовы вне белого списка завершаются ошибкой до любых Graph-запросов. Для многошаговых сценариев составления/проверки используйте draft (действие create → update → send), так как черновики можно просмотреть в Outlook перед отправкой. Строки получателей через запятую или массивы — оба варианта допустимы.

Обновляет состояние сообщения без изменения содержимого (идемпотентно — безопасно для повторного вызова).action=mark-read / mark-unread переключает флаг isRead у одного сообщения по id.action=flag устанавливает флаг для последующего выполнения с опциональными dueDateTime / startDateTime (ISO 8601).action=unflag снимает флаг.action=complete отмечает флаг как выполненный.Flag / unflag / complete принимают либо id (одиночный), либо ids (массив для пакетной обработки) — пакетные операции используют Graph $batch для эффективности.Возвращает подтверждение статуса для каждого сообщения.