Skip to main content
Glama
jatinpurba

outlook-legacy-mcp

by jatinpurba

Outlook Legacy MCP

Подключите Claude Desktop к устаревшим установкам Microsoft Outlook с помощью автоматизации Windows COM.

Этот проект предназначен специально для Outlook 2007 и аналогичных устаревших настольных сред Outlook, где современные интеграции Outlook/Microsoft 365 могут быть недоступны или непрактичны.

Как это работает

Claude Desktop
      |
      | MCP
      v
Outlook Legacy MCP Server
      |
      | Windows COM / MAPI
      v
Microsoft Outlook Desktop
      |
      v
Configured Outlook Mail Profile

MCP-сервер работает локально на компьютере с Windows. Он не подключается напрямую к Exchange, IMAP, SMTP или Microsoft Graph.

Related MCP server: outlook-mcp

Ключевая особенность: никаких учётных данных Outlook в MCP

Сервер не запрашивает и не хранит:

  • имя пользователя Outlook

  • пароль Outlook

  • данные сервера Exchange

  • учётные данные IMAP/SMTP

  • учётные данные Microsoft Graph

  • токены OAuth

Вместо этого он использует настольное приложение Outlook и почтовый профиль, уже настроенный на локальном компьютере с Windows.

Текущие инструменты MCP

Tool

Description

list_emails

Список последних сообщений из «Входящих» или папки верхнего уровня

read_email

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

create_draft

Создание и сохранение черновика письма

send_email

Отправка письма через Outlook

Требования

  • Windows

  • Microsoft Outlook 2007 или другая настольная версия Outlook, совместимая с COM

  • Python 3.10+

  • Claude Desktop

  • Настроенный почтовый профиль Outlook

Outlook должен быть открыт на компьютере хотя бы один раз, чтобы его профиль был настроен.

Установка

Клонируйте репозиторий:

git clone https://github.com/jatinpurba/outlook-legacy-mcp.git
cd outlook-legacy-mcp

Установите зависимости:

pip install -r requirements.txt

Вы также можете установить их напрямую:

pip install pywin32 mcp

Настройка Claude Desktop

Откройте файл конфигурации Claude Desktop:

%APPDATA%\Claude\claude_desktop_config.json

Добавьте следующую запись MCP-сервера. Замените путь на фактическое расположение файла Python на вашем компьютере:

{
  "mcpServers": {
    "outlook-legacy": {
      "command": "python",
      "args": [
        "C:\\path\\to\\outlook-legacy-mcp\\outlook_mcp_server.py"
      ]
    }
  }
}

Сохраните конфигурацию и полностью перезапустите Claude Desktop.

После этого инструменты Outlook должны стать доступны для Claude.

Примеры запросов

После подключения вы можете просить Claude о таких вещах, как:

Show me my latest 10 emails.
Show me my unread emails.
Read the latest email from John.
Create a draft response to this email.
Create a draft email to customer@example.com with the subject
"Project Update".

Будьте особенно осторожны с send_email, поскольку он отправляет сообщение через вашу настроенную учётную запись Outlook.

Безопасность и конфиденциальность

Этот MCP-сервер работает локально на вашем компьютере с Windows.

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

Однако инструменты MCP могут получать доступ к содержимому почтового ящика и отправлять электронные письма. Запускайте сервер только на доверенном компьютере.

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

Outlook может отображать запрос безопасности, когда программа пытается отправить почту от вашего имени. Это функция безопасности Outlook.

Ограничения

  • Только Windows

  • Требуется настольный Outlook

  • Требуется настроенный профиль Outlook

  • Использует автоматизацию Outlook Windows COM

  • Предназначен для локального использования, а не для серверных/безголовых развёртываний

  • Для операций COM Outlook может потребоваться запущенным или запускаемым

  • При отправке почты могут появляться запросы безопасности Outlook

  • Текущая реализация сосредоточена на операциях с электронной почтой

Почему не Microsoft Graph?

Microsoft Graph — отличный вариант для современных сред Microsoft 365.

Этот проект нацелен на другой сценарий использования: устаревший настольный Outlook.

Если вы используете Outlook 2007 или другую устаревшую среду, где современные интеграции на основе Outlook/Graph недоступны или непрактичны, этот проект предоставляет локальный MCP-мост на основе COM.

Архитектура

Сервер использует Python, pywin32, автоматизацию Outlook COM и MCP Python SDK.

MCP-сервер получает приложение Outlook через COM и обращается к его пространству имён MAPI. Таким образом, он использует уже настроенный на машине профиль Outlook, а не реализует отдельный процесс аутентификации на почтовом сервере.

Разработка

Установите зависимости:

pip install -r requirements.txt

Запустите сервер:

python outlook_mcp_server.py

Сервер предназначен для запуска MCP-совместимым клиентом, таким как Claude Desktop.

Участие в разработке

Приветствуются сообщения об ошибках, улучшения, отчёты о совместимости и pull request'ы.

Если вы тестируете проект с другой устаревшей версией Outlook, укажите версию Outlook и версию Windows в вашем сообщении.

Лицензия

Лицензия MIT. См. LICENSE.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to read, send, and manage Outlook mail locally on Windows via COM/MAPI, without cloud APIs.
    182 npm
    1
    MIT
  • F
    license
    Not graded
    quality
    B
    maintenance
    Connects Claude Desktop to Outlook via the Microsoft Graph API, enabling users to list, search, and organize emails directly through conversation.
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to securely interact with the classic Outlook desktop client on Windows via COM, covering mail, calendar, contacts, tasks, categories, and rules. It enforces draft-first outbound email, send gating, and recipient domain allowlisting for restricted environments without Graph, OAuth, or Azure app registration.
    MIT