WorkMail MCP Server

Сервер протокола контекста модели (MCP), который подключает Claude Desktop к Amazon WorkMail, обеспечивая доступ к электронной почте и календарю через безопасный локальный транспорт stdio.

Функции

Related MCP server: Gmail & Calendar Multi-Account MCP Server

Безопасность

• Учетные данные хранятся в macOS Keychain (аппаратно зашифрованы на Apple Silicon) — никогда не хранятся в файлах конфигурации или переменных окружения

• Транспорт использует stdio (локальный канал) — нет HTTP-сервера, нет открытых портов

• Шифрование канала через HTTPS/TLS до конечной точки EWS в WorkMail

• Валидация входных данных при каждом вызове инструмента через схемы Zod

• Очистка выходных данных удаляет значения учетных данных из всех ответов и сообщений об ошибках

• Ограничение частоты запросов (Rate limiting) предотвращает бесконечные циклы запросов (настраиваемое, по умолчанию 30/мин)

• Защита от записи — send_email и create_calendar_event требуют параметр confirm: true

Предварительные требования

• macOS (использует Keychain для хранения учетных данных)

• Node.js 20+

• Учетная запись Amazon WorkMail с аутентификацией по имени пользователя и паролю

Настройка

1. Установка зависимостей

git clone https://github.com/your-username/workmail-mcp-server.git
cd workmail-mcp-server
npm install

2. Настройка окружения

cp .env.example .env

Отредактируйте .env, если ваш WorkMail находится в другом регионе:

WORKMAIL_MCP_EWS_ENDPOINT=https://ews.mail.us-west-2.awsapps.com/EWS/Exchange.asmx

Конечная точка EWS соответствует шаблону https://ews.mail.<region>.awsapps.com/EWS/Exchange.asmx. Распространенные регионы: us-east-1, us-west-2, eu-west-1.

3. Сохранение учетных данных

npm run setup-credentials

Это действие запросит ваш email и пароль от WorkMail, сохранит их в macOS Keychain и проверит подключение.

4. Сборка

npm run build

5. Регистрация в Claude Desktop

Добавьте следующее в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "workmail": {
      "command": "node",
      "args": ["/absolute/path/to/workmail-mcp-server/dist/index.js"]
    }
  }
}

Перезапустите Claude Desktop. Сервер WorkMail должен отобразиться как подключенный.

Конфигурация

Все настройки являются необязательными и имеют разумные значения по умолчанию. Установите их в .env или в качестве переменных окружения:

Переменные окружения, установленные в claude_desktop_config.json, имеют приоритет над .env.

Использование

После подключения попросите Claude Desktop взаимодействовать с вашим WorkMail:

• "List my recent emails"

• "Read the email from Sarah about the Q3 report"

• "Search my inbox for messages about the deployment"

• "What meetings do I have this week?"

• "Send an email to team@example.com about the status update"

• "Create a meeting for tomorrow at 2pm with Alex"

Разработка

# Run directly from TypeScript (no build step)
npm run dev

# Rebuild after changes
npm run build

# Re-run credential setup
npm run setup-credentials

Логи записываются в stderr в формате JSON. Чтобы увидеть их при работе через Claude Desktop, проверьте логи MCP-сервера в инструментах разработчика Claude Desktop.

Архитектура

Claude Desktop  <──stdio──>  MCP Server (Node.js)
                                  │
                                  ▼
                            EWS Client Layer
                                  │
                                  ▼
                  Amazon WorkMail (Exchange Web Services)

Сервер использует протокол EWS на уровне совместимости Exchange2010_SP2, который является версией, поддерживаемой Amazon WorkMail.

Лицензия

MIT