OutlookMCP服务器

该项目是一个 MCP 服务器，它允许 Claude Desktop 使用 Microsoft Graph API 访问您的 Microsoft 365 邮件、日历和（即将推出的）文件。

✨ 特点

✅邮件访问：通过 Claude 或任何兼容 MCP 的代理撰写、回复、排序、搜索、过滤和分析您的收件箱
🔜日历支持：按日期列出、撰写、删除邮件（即将推出：更新邮件、搜索）
🚧 OneDrive 支持：邮件和日历功能强大后的未来可能方向

Related MCP server: Mailmodo

🧱 技术栈

msgraph （现代 Microsoft Graph SDK）
带有DeviceCodeCredential和TokenCachePersistenceOptions``azure.identity
FastMCP — 简单的 MCP 兼容服务器接口
uv — 快速 Python 依赖和环境管理

⚙️ 要求

目前构建的目的是：

在macOS上本地运行
与Claude Desktop一起使用
使用Azure 注册的应用程序进行身份验证

⚠️ 您必须具有Azure 租户的管理员访问权限才能配置此功能 - 应用程序注册需要 Microsoft Graph 范围的同意（例如Mail.Read 、 Calendars.Read ），而在大多数组织中，默认情况下这是不需要用户同意的。

🚀 入门

# Set up the environment
uv venv
uv pip install -r uv.lock

# Run locally using MCP Inspector
mcp dev main.py (expect errors)

在尝试在 Claude 中进行调试之前，先在 Inspector 中让事情运行起来要容易得多。

🔐 身份验证设置

在运行应用程序之前，您需要设置以下内容：

在项目根目录中创建一个 auth_cache 文件夹（参见注释）：

mkdir -p auth_cache

touch .env

将以下内容添加到 .env：

echo "AZURE_CLIENT_ID=<your-id-from-Azure-portal-here>" > .env
echo "AZURE_TENANT_ID=<your-id-from-Azure-portal-here>" >> .env
echo "AZURE_GRAPH_SCOPES=User.Read Mail.Read Mail.Send Mail.ReadWrite" >> .env

注意：首次运行时，应用程序将使用 DeviceCodeCredential 流进行身份验证，如果成功，将自动在 auth_cache 文件夹中创建 auth_record.json。

您必须具有 Azure 租户的管理员访问权限才能注册具有这些权限的应用程序。

Claude 用于桌面集成

要与 Claude Desktop 集成，请将其添加到您的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "outlook": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "azure-identity,mcp[cli],msgraph-core,msgraph-sdk",
        "mcp",
        "run",
        "/absolute/path/to/OutlookMCPServer"
      ]
    }
  }
}

在 Claude Desktop 中，您可以通过“设置/开发人员/编辑配置”找到 json 文件。

注意：您可能需要在“命令”中将“uv”替换为绝对引用

每次更改配置或服务器代码时，请重新启动 Claude Desktop。

📦文件夹结构

.
├── README.md
├── main.py
├── settings.py
├── auth_cache/
│   └── auth_record.json
├── mcpserver/
│   └── graph/
│       ├── __init__.py
│       ├── calendar_service.py
│       ├── controller.py
│       ├── mail_service.py
│   ├── __init__.py
│   ├── auth_wrapper.py
│   ├── context_manager.py
│   ├── mail_query.py
│   ├── message_info.py
│   └── server.py
├── tests/
├── .env
├── __init__.py
├── main.py