M365 MCP
](https://www.npmjs.com/package/@masonator/m365-mcp)  ](https://nodejs.org)  
通过Microsoft Graph API为Microsoft 365提供MCP服务器。从任何MCP客户端对您的个人资料、日历、电子邮件、团队聊天、OneDrive文件和会议记录进行只读访问。
安装
克劳德代码
claude mcp add m365-mcp -e MS365_MCP_CLIENT_ID=your-client-id -e MS365_MCP_TENANT_ID=your-tenant-id -- npx -y @masonator/m365-mcp克劳德桌面
添加到您的Claude桌面配置(claude_desktop_config.json):
{
"mcpServers": {
"m365-mcp": {
"command": "npx",
"args": ["-y", "@masonator/m365-mcp"],
"env": {
"MS365_MCP_CLIENT_ID": "your-azure-ad-client-id",
"MS365_MCP_TENANT_ID": "your-azure-ad-tenant-id"
}
}
}
}首次运行
首次使用时，服务器会打开您的浏览器以使用Microsoft登录。在获得同意后，代币将存储在本地 ~/.config/m365-mcp/tokens.json （权限 600)并自动刷新。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
MS365_MCP_CLIENT_ID | 是 | Azure AD应用程序（客户端）ID |
MS365_MCP_TENANT_ID | 是 | Azure AD租户ID |
MS365_MCP_CLIENT_SECRET | 否 | Azure AD客户端机密（仅限机密客户端） |
MS365_MCP_TIMEZONE | 否 | 日历时区（默认：系统时区） |
MS365_MCP_REDIRECT_URL | 否 | OAuth重定向URI（默认：动态端口， http://localhost:{port}/callback) |
Azure AD安装程序
使用以下设置在Azure AD中注册应用程序：
- 应用程序注册 >新注册
- 重定向URI:
http://localhost（Web平台）--或通过以下方式设置固定URIMS365_MCP_REDIRECT_URL - 证书和秘密 >新客户机密
- API权限 >添加以下内容 委派 权限：
- User.Read - Calendars.Read - Mail.Read - Chat.Read - Files.Read - OnlineMeetingTranscript.Read.All - Sites.Read.All
工具
ms_auth_status
检查连接状态。如果未连接，则打开浏览器登录。
ms_profile
获取您的Microsoft 365个人资料——显示姓名、电子邮件、职位、办公地点。
ms_calendar
获取日历事件。默认为今天。
| 参数 | 说明 |
|---|---|
date | 具体日期（YYYY-MM-DD） |
start | 范围起始（ISO 8601） |
end | 范围结束（ISO 8601） |
ms_mail
使用可选关键字搜索阅读最近的电子邮件。
| 参数 | 说明 |
|---|---|
search | 用于过滤电子邮件的关键字 |
count | 电子邮件数量（1-25，默认10） |
ms_chat
阅读团队聊天。没有 chat_id 列出最近的聊天记录；随着 chat_id 从该线程返回消息。
| 参数 | 说明 |
|---|---|
chat_id | 特定聊天线程ID |
count | 项目数量（1-25，默认10） |
ms_files
浏览或搜索OneDrive文件。
| 参数 | 说明 |
|---|---|
path | 文件夹路径（例如。， /Documents) |
search | 跨OneDrive搜索 |
count | 最大项目数（1-50，默认20） |
ms_transcripts
获取团队会议记录。返回预览（约3000个字符） transcript_id 深入查看完整的成绩单。
| 参数 | 说明 |
|---|---|
date | 日期（YYYY-MM-DD） |
start | 范围起始（ISO 8601） |
end | 范围结束（ISO 8601） |
transcript_id | 来自以前完整内容列表调用的ID |
发展
git clone https://github.com/StuMason/m365-mcp.git
cd m365-mcp
npm install
npm run build
npm test贡献
看 贡献.md 了解详情。
许可证
麻省理工学院 -斯图·梅森