🚀 MCP Outlook 工具
MCP Outlook 工具是一个基于模型上下文协议（MCP）的服务器实现，它让 AI 助手能够与 Microsoft Outlook 进行交互，实现日历管理、邮件操作和搜索功能。
✨ 主要特性
-
📅 日历管理
- 获取指定日期范围内的日历项。
- 添加包含完整详细信息的新预约。
- 支持分类和忙碌状态设置。
-
📧 邮件操作
- 向收件人及抄送对象发送邮件。
- 发送前显示确认信息。
- 支持完整的邮件正文格式设置。
-
🔍 邮件搜索
- 按日期和关键词搜索邮件。
- 从地址中提取用户信息。
- 支持日文文本编码。
📦 安装指南
环境要求
- Windows 操作系统（pywin32 依赖）。
- 已安装并配置好 Microsoft Outlook。
- Python 3.10 或更高版本。
- 兼容 MCP 的 AI 助手（如 Claude Desktop）。
安装步骤
- 克隆仓库：
git clone https://github.com/wmoto-ai/mcp-outlook-tools.git
cd mcp-outlook-tools
- 使用 uv 安装依赖：
uv pip install -e .
或者使用 pip 安装：
pip install -e .
📚 详细文档
配置
针对 Claude Desktop
将以下内容添加到你的 Claude Desktop 配置文件中：
Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"outlook-tools": {
"command": "uv",
"args": [
"--directory",
"C:/path/to/mcp-outlook-tools",
"run",
"--with-editable",
".",
"-m",
"outlook_tools.server"
],
"cwd": "C:/path/to/mcp-outlook-tools",
"env": {
"PYTHONIOENCODING": "utf-8"
}
}
}
}
使用方法
配置完成后，你的 AI 助手将可以使用以下工具：
add_appointment
向 Outlook 日历添加新预约
参数:
- subject: 预约标题
- start_time: 开始日期和时间（YYYY-MM-DD HH:MM）
- end_time: 结束日期和时间（YYYY-MM-DD HH:MM）
- location: 会议地点（可选）
- description: 详细描述（可选）
- categories: 以逗号分隔的分类（可选）
- busy_status: 0=空闲, 1=暂定, 2=忙碌, 3=不在办公室（默认: 1）
get_calendar
获取指定日期范围内的日历项
参数:
- start_date: 开始日期（YYYY-MM-DD）
- end_date: 结束日期（YYYY-MM-DD）
send_email
通过 Outlook 发送邮件
参数:
- to: 收件人邮箱地址（以分号分隔）
- cc: 抄送收件人（以分号分隔）
- subject: 邮件主题
- body: 邮件正文文本
项目结构
mcp-outlook-tools/
├── src/
│ └── outlook_tools/
│ ├── __init__.py
│ ├── server.py # MCP 服务器实现
│ ├── calendar_service.py # 日历操作
│ └── search_service.py # 邮件搜索操作
├── test/ # 测试文件
├── pyproject.toml # 项目配置
└── README.md # 本文件
开发
运行测试
pytest test/
类型检查
pyright src/
代码检查
ruff check src/
安全注意事项
- 此工具需要访问你本地安装的 Outlook。
- 邮件在发送前会显示给用户确认。
- 代码中不存储任何凭证。
- 所有操作都使用 Windows COM 接口，并依赖现有的 Outlook 身份验证。
局限性
- 仅支持 Windows 系统（由于依赖 pywin32）。
- 需要安装并配置好 Outlook。
- 时区处理假设为日本标准时间（JST，+9 小时）。
贡献
欢迎贡献代码！请随时提交拉取请求。
许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。
致谢
- 基于 FastMCP 框架构建。
- 使用 pywin32 实现 Outlook COM 接口。