阿里邮箱MCP服务说明
时间：2025-09-15 12:37:12 作者：喜米网络 来源：阿里云说明
该功能仅AI尊享版支持，版本差异请参考版本介绍。
调用邮箱MCP的效果和AI智能体基础能力有关，建议对AI智能体做好提示词和知识库的优化。
一、邮箱MCP服务是什么
MCP，全称模型上下文协议（Model Context Protocol），目标是为大语言模型和AI助手提供一个统一、标准化的接口。它的作用就像USB接口一样，使AI能够轻松连接和操作外部工具并完成更复杂的任务。
邮箱现已支持MCP协议，用户可以通过此协议授权AI操作自己的邮箱，并可通过与AI聊天在邮箱中发送邮件，获取需要的邮件信息。
二、邮箱MCP服务包含哪些能力
具体的工具详细描述和参数等信息可以通过MCP的工具查询接口查看。
tools列表
搜索邮件： search_mail
基于KQL表达式，支持日期、关键词等条件搜索邮件。
获取邮件：get_mail
基于邮件id（可以通过搜索邮件获得），获取完整邮件内容，包含收发件人及正文等。
生成草稿：create_draft
生成邮件内容草稿，并保存在「草稿箱」文件夹。
发送邮件：send
指定收件人、主题、正文发送邮件。
获取日历：list_calendars
获取账号日历信息，包括 ID，名字，是否共享等信息，默认日历 Id 是 1，名字是calendar。
获取日历视图：get_calendar_events_view
根据日历 ID 获取指定时间区间的日程列表。
获取日程详情：get_calendar_event
根据日历 ID 和日程 ID（获取日历视图接口可以获取日程 ID） 获取日程详情，包括开始结束时间、组织者、参会人、主题和正文等。
创建或发送日程：create_calendar_event
指定组织者、参会人和开始结束时间等，创建或发送日程，其中 notify 设为 true，则会发送日程给参会人，若 notify 设为 false，则只在组织者日历中创建日程，并不会发送给参会人。
三、如何使用邮箱MCP服务
在邮箱配置MCP服务
步骤 1：进入邮箱设置-MCP服务
步骤 2：生成Token
复制Token或JSON配置
配置MCP客户端
示例1：在钉钉AI助理配置邮箱MCP
示例2：在阿里云百炼配置邮箱MCP
示例3：在通义灵码配置邮箱MCP
常见问题
错误信息1： failed to initialize MCP client for alimail: [35244] Warning: ignoring invalid header argument: "Authorization: [35244] Using automatically selected callback port: 30785 [35244] [35244] Connecting to remote server: https://qiye.aliyun.com/mcp/streamable/ [35244] Using transport strategy: http-first Could not load OAuth Protected Resource metadata, falling back to /.well-known/oauth-authorization-server Error: Resource server does not implement OAuth 2.0 Protected Resource Metadata. 错误信息2： Could not load OAuth Protected Resource metadata, falling back to /.well-known/oauth-authorization-server Error: Resource server does not implement OAuth 2.0 Protected Resource Metadata. 原因可能是命令拼接不正确，不同的AI工具对MCP支持格式有少许不同，比如是否带引号。 如： Windows命令行：token需要带有引号 通义灵码：界面配置token不需要引号 阿里云百炼提示： 请确认JSON配置是否正确，请尝试重新从阿里邮箱生成或复制JSON值。npx -y mcp-remote@latest https://qiye.aliyun.com/mcp/streamable/ --header "Authorization: Bearer <token>"
