Skip to main content
Glama
Sign In
Outlook MCP

Outlook MCP

by heist1337
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Outlook MCP

Check Python 3.12 MIT

Почта и календарь локального Exchange через EWS для MCP-агентов. FastMCP · Streamable HTTP · запуск через uv или Docker.

Поиск и чтение писем, вложения, папки, календарь, занятость и подписанные планы изменений. Каждому пользователю нужны собственная учётная запись Exchange и сетевой доступ к его серверу. Это коннектор EWS, а не Microsoft Graph.

Запуск за несколько минут

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

git clone https://github.com/vampire1337/outlook-mcp.git
cd outlook-mcp
cp .env.example .env
uv run --locked python -c "import secrets; print(secrets.token_urlsafe(32))"

В .env указать EWS_ENDPOINT, EWS_SERVER, EWS_EMAIL, EWS_USERNAME, EWS_PASSWORD и записать сгенерированный токен в BRIDGE_API_TOKEN. При необходимости подключить корпоративный VPN. На Windows вместо cp использовать Copy-Item .env.example .env в PowerShell.

uv run --locked --env-file .env outlook-mcp

Оставить терминал открытым. MCP доступен на http://127.0.0.1:8080/mcp/; проверка процесса — http://127.0.0.1:8080/healthz. Python и зависимости uv устанавливает по uv.lock.

Related MCP server: OWA Exchange MCP Server

Подключение агента

В клиенте с HTTP MCP указать URL и заголовок:

URL: http://127.0.0.1:8080/mcp/
Authorization: Bearer <ваш BRIDGE_API_TOKEN>

Для клиентов с mcp.json — пример конфигурации. Сначала вызвать outlook_capabilities, затем mail_folders или calendar_upcoming. Полный список инструментов и настроек.

Нужно

Опция в .env

Текст писем

EWS_MAIL_BODY_ENABLED=true

Вложения

EWS_MAIL_ATTACHMENTS_ENABLED=true

Контекст календаря и подробности встреч

EWS_CALENDAR_CONTEXT_ENABLED=true

Названия встреч

EWS_ALLOW_EVENT_SUBJECTS=true

Контакты, задачи и прочие расширенные чтения

EWS_EXTENDED_READS_ENABLED=true

Docker

docker compose up --build -d
docker compose logs --tail=30

Нужен обычный Docker Engine с Compose. Состояние хранится в отдельном томе; порт доступен только на локальном компьютере. Детали.

Изменения и перенос

Запись выключена по умолчанию. Для неё нужны отдельный токен, явно разрешённые группы операций и отдельное MCP-подключение. Используются outlook_prepare → outlook_execute с журналом результатов; при неизвестном результате сначала сверить состояние. Настройка записи.

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

Разработка · Безопасность · MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers

  • OWA Exchange MCP Server

    nhype
    A
    license
    A
    quality
    C
    maintenance
    MCP server for any Microsoft Exchange / OWA deployment. Gives LLM agents access to email, calendar, directory search, folders, availability, and meeting analytics via 30 tools.
    30
    46 PyPI
    12
    MIT

  • Exchange Mail MCP Server

    timeagent4-lang
    -
    license
    Not graded
    quality
    B
    maintenance
    Secure MCP server for Microsoft Exchange. It enables authorized users to list, search, read, download attachments, send, and reply to email via EWS with strict access control and audit.
    -