outlook-classic-windows-mcp

MVP MCP-сервер для работы с локально настроенным профилем классического Outlook для Windows.

Он не использует Microsoft Graph, Outlook в Интернете, новый Outlook для Windows или облачные API с правами администратора. Он использует Windows COM-автоматизацию для работы с классическим настольным приложением/профилем Outlook, доступным на машине, где запущен MCP-сервер. Это полезно, если вы не хотите иметь дело с вашей ИТ-поддержкой или просить благословения у вашего администратора.

Примечание: этот MCP специфичен для моего собственного рабочего процесса и требований. Рекомендуется сделать форк и изменить его — или попросить вашего агента-кодера сделать это за вас, — чтобы адаптировать MCP под вашу собственную настройку Outlook и сценарий использования.

Предупреждение: классический Outlook для Windows для пользователей Microsoft 365 поддерживается как минимум до 2029 года. Новый Outlook постепенно становится стандартным или заменяет классический. Этот MCP будет жизнеспособен только в ближайшей/среднесрочной перспективе. В долгосрочной перспективе используйте другой MCP, который использует API с поддержкой администратора! См. https://learn.microsoft.com/en-us/answers/questions/5554339/when-will-classic-outlook-end

Требования

• Windows

• Классический Microsoft Outlook для настольного ПК установлен и настроен

• uv

Установка / запуск

cd C:\Users\muhammad.menjeni\git\outlook-classic-windows-mcp
uv sync
uv run outlook-local-mcp

MCP-сервер работает через stdio, поэтому он предназначен для запуска MCP-клиентом.

Пример конфигурации Pi MCP

Добавьте запись локального сервера, аналогичную этой, в вашу конфигурацию Pi MCP, при необходимости скорректировав путь:

{
  "mcpServers": {
    "outlook-local": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\muhammad.menjeni\\git\\outlook-classic-windows-mcp",
        "run",
        "outlook-local-mcp"
      ]
    }
  }
}

Инструменты

search_email

Выполняет поиск почты Outlook по теме и/или телу сообщения.

Аргументы:

• query string: подстрока для поиска без учёта регистра.

• folder string: папка для поиска. По умолчанию: Inbox. Можно использовать пути вида Inbox/Archive или Mailbox Name/Inbox.

• search_scope: all, subject или body. По умолчанию: all.

• max_results: количество совпадений для возврата. По умолчанию: 10.

• max_items: количество новейших элементов для проверки в папке. По умолчанию: 500.

• include_body_preview: включать краткий предпросмотр тела сообщения. По умолчанию: true.

list_mail_folders

Выводит список доступных папок Outlook, чтобы помочь выбрать путь к папке.

create_leave_calendar_blocks

Создаёт два неотправленных элемента календаря Outlook для согласования отпуска:

1. Личный блокирующий элемент с пометкой Out of Office без участников.

2. Уведомительное собрание с пометкой Free с указанными участниками.

Ничего не отправляется. По умолчанию оба элемента сохраняются и открываются в Outlook для ручной проверки/отправки.

Аргументы:

• start_time string: дата/время начала, например 2026-09-01 08:00.

• end_time string: дата/время окончания. Для событий на весь день конечная дата не включается, например, один день с 2026-09-04 00:00 до 2026-09-05 00:00.

• required_attendees list/string: дополнительные получатели уведомления. Также можно использовать настраиваемые значения по умолчанию.

• subject string: по умолчанию берётся из конфигурации, изначально Amirul: On-Leave.

• body string: текст сообщения.

• optional_attendees list/string: необязательные получатели уведомления.

• location string.

• display boolean: открыть сохранённые элементы в Outlook. По умолчанию: true.

• confirmed boolean: должно быть true, чтобы фактически создать элементы календаря Outlook. Без подтверждения инструмент возвращает только предложение.

get_leave_defaults

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

set_leave_defaults

Сохраняет значения по умолчанию для отпуска, такие как тема и получатели уведомлений. Требует confirmed=true перед записью конфигурации.

infer_leave_recipients

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

resolve_recipients

Разрешает имена, адреса электронной почты или списки рассылки с помощью разрешения получателей Outlook/адресной книги.

search_contacts

Выполняет поиск по локальным папкам контактов Outlook по имени, адресу электронной почты, компании, отделу или должности.

Примечания / ограничения

• При первом обращении Outlook может быть запущен, если он ещё не запущен.

• Ваша организация может показывать запросы Outlook Object Model Guard или блокировать автоматизацию по политике.

• Этот MVP выполняет поиск путём сканирования недавних элементов папки, что просто и надёжно, но не так быстро, как индексированный поиск Outlook для очень больших папок.