阿里邮箱MCP服务官方说明
时间：2026-10-26 16:44:40 作者：超级管理员一、邮箱MCP服务是什么
MCP，全称模型上下文协议（Model Context Protocol），目标是为大语言模型和AI助手提供一个统一、标准化的接口。它的作用就像USB接口一样，使AI能够轻松连接和操作外部工具并完成更复杂的任务。
邮箱现已支持MCP协议，用户可以通过此协议授权AI操作自己的邮箱，并可通过与AI聊天在邮箱中发送邮件，获取需要的邮件信息。
二、邮箱MCP服务包含哪些能力
具体的工具详细描述和参数等信息可以通过MCP的工具查询接口查看。
功能 | 工具名称 | 作用 |
批量更新邮件 | batch_update_emails | 批量标记邮件已读或未读、添加或移除标签；单次最多 100 封，一次执行一种操作。 |
创建日程 | create_calendar_event | 在指定日历创建约会或会议，支持循环日程，并可向参会人发送邮件通知。 |
创建邮件附件上传会话 | create_email_attachment_upload_url | 为草稿邮件创建附件上传会话，返回临时上传地址；客户端上传文件后，附件才会关联到草稿。 |
创建邮件草稿 | create_email_draft | 在草稿箱中创建邮件草稿，保存主题、正文和收件人等信息；创建后不自动发送。 |
转发(草稿) | create_email_forward_draft | 基于原邮件创建转发草稿，可设置转发正文和收件人；后续通过发送草稿接口发出。 |
回复全部(草稿) | create_email_reply_all_draft | 基于原邮件创建回复全部草稿，回复范围包含发件人、原收件人和抄送人；创建后不自动发送。 |
回复(草稿) | create_email_reply_draft | 基于原邮件创建回复草稿，回复发件人；原邮件设置 Reply-To 时优先回复该地址，创建后不自动发送。 |
创建邮件文件夹 | create_mail_folder | 创建邮件文件夹，可通过父文件夹 ID 指定创建位置。 |
批量删除邮件 | delete_emails | 按邮件 ID 批量删除邮件，单次最多 100 封。 |
删除邮件文件夹 | delete_mail_folder | 按文件夹 ID 删除邮件文件夹，仅支持删除空文件夹。 |
获取日程详情 | get_calendar_event | 按用户邮箱、日历 ID 和日程 ID 获取日程的详细信息。 |
获取邮件详情 | get_email | 按邮件 ID 获取邮件详情；默认返回基本字段，可通过 $select 获取正文、收件人等扩展信息。 |
获取邮件附件下载地址 | get_email_attachment_download_url | 为指定邮件附件获取临时下载地址，供客户端后续下载附件文件。 |
获取会话 | get_email_conversation | 获取邮件会话的主题、摘要、邮件数和已读状态等概览；当前不返回会话内的邮件明细。 |
查询时间范围内的日程 | list_calendar_view | 查询指定日历在时间范围内的日程，并将循环日程展开为单次日程；支持游标分页。 |
查询日历列表 | list_calendars | 查询用户可访问的日历列表，包括自建日历及接受共享后生成的日历。 |
查询邮件附件列表 | list_email_attachments | 按邮件 ID 查询邮件的全部附件，获取附件 ID 等信息。 |
列出会话 | list_email_conversations | 按文件夹分页列出邮件会话，支持时间范围与时间排序，单次最多 100 条。 |
查询邮件文件夹列表 | list_mail_folders | 查询顶层或指定父文件夹下的子文件夹，可选择递归返回全部层级。 |
批量移动邮件 | move_emails | 将邮件批量移动到目标文件夹，单次最多 100 封；目标文件夹不能是草稿箱。 |
搜索邮件 | search_emails | 按主题、正文、发件人、收件人、时间等条件搜索邮件，支持组合查询和分页，单页最多 100 封。 |
搜索用户-关键字 | search_users | 按姓名、昵称、拼音、工号或办公地点等关键词搜索同域用户，获取邮箱地址等信息。 |
发送邮件 | send_email | 按主题、HTML 正文和收件人等信息创建新邮件并立即发送，一次调用完成发信。 |
发送邮件草稿 | send_email_draft | 按草稿邮件 ID 发送草稿箱中的邮件，可指定是否保存到已发送文件夹。 |
更新邮件草稿 | update_email_draft | 修改已有草稿的主题、正文和收件人等信息，仅支持草稿箱中的草稿邮件。 |
更新邮件文件夹名称 | update_mail_folder | 按文件夹 ID 修改邮件文件夹名称。 |
三、如何使用邮箱MCP服务
在邮箱配置MCP服务
步骤 1：进入邮箱设置-AI智能-MCP服务，点击生成Token，输入Token用途，设置过期时间。
步骤 2：复制Token或JSON配置
常见问题
错误信息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>"
