---
docType: mcp
---

# 邮箱

支持对用户邮件的查询、创建、发送和导入等功能。

## 更新记录

| 日期 | 更新内容 |
|------|----------|
| 2026/01/08 | 更新到版本 2.0.0 |
| 2025/09/04 | 工具第一次上线 |

## 概况

| Tool Name | 工具名称 |
|----------|----------|
| kso_mail_search_letter | 搜索邮件 |
| kso_mail_get_letter | 获取指定邮件 |
| kso_mail_send_draft | 发送草稿邮件 |
| kso_mail_create_draft | 创建草稿 |
| kso_mail_list_letter | 获取邮件列表 |

## 权限依赖
`delegated:kso.mcp_mail.readwrite`
## 地址
服务URL: https://openapi.wps.cn/mcp/v2/kso-mail/message

## Tools
本MCP Server提供以下tools:

### 1. 搜索邮件（kso_mail_search_letter）

#### 工具描述
搜索已登录用户账号下符合特定条件的邮件列表，按发信日期由近及远。支持搜索条件包括发件人、收件人、主题、邮件正文等

#### 输入说明
```
keyword：string类型，必填（关键字，必填）
type：string类型，可选（关键字类型：all/sender/receiver/subject/body，默认为subject）
filter：array类型，可选（邮件筛选条件，字符串数组，可选值：unread（未读邮件）、flagged（星标邮件），例如：[\"unread\", \"flagged\"]）
page_size：number类型，可选（分页大小，默认10，最大50）
page_token：string类型，可选（翻页token，首次无需提供）
start_time：number类型，可选（邮件的起始时间戳（单位秒））
end_time：number类型，可选（邮件的结束时间戳（单位秒））
```

### 2. 获取指定邮件（kso_mail_get_letter）

#### 工具描述
从已登录用户有相中获取指定邮件的完整内容，包括邮件正文、附件、收发件人等详细信息

#### 输入说明
```
message_id：string类型，必填（邮件ID，必填）
with_ocr_body：boolean类型，可选（是否需要OCR识别后的邮件体）
with_importance_flag：boolean类型，可选（是否需要邮件重要性标识）
```

### 3. 发送草稿邮件（kso_mail_send_draft）

#### 工具描述
将已登录用户草稿箱中的指定草稿邮件投递发送出去

#### 输入说明
```
message_id：string类型，必填（草稿邮件ID）
```

### 4. 创建草稿（kso_mail_create_draft）

#### 工具描述
创建一封新的邮件草稿并将其存储于已登录用户的草稿箱中，支持设置收件人、抄送、密送等邮件属性

#### 输入说明
```
subject：string类型，必填（邮件标题，必填）
to_recipients：array类型，必填（收件人列表，每个元素为对象，包含：
  - name：string类型，可选（收件人姓名，传入email_address时必传）
  - email_address：string类型，可选（收件人邮箱地址，与keyword二选一）
  - keyword：string类型，可选（用户关键字搜索，支持用户名、邮箱等，与name+email_address二选一）
  示例：[{\"name\":\"张三\",\"email_address\":\"zhangsan@example.com\"}] 或 [{\"keyword\":\"张三\"}]）
cc_recipients：array类型，可选（抄送人列表，格式同to_recipients，每个元素为对象，包含name、email_address或keyword字段）
bcc_recipients：array类型，可选（密送人列表，格式同to_recipients，每个元素为对象，包含name、email_address或keyword字段）
body：string类型，可选（邮件内容）
```

### 5. 获取邮件列表（kso_mail_list_letter）

#### 工具描述
获取已登录用户邮箱中的邮件列表，支持时间范围筛选和邮件状态过滤，按时间排序展示

#### 输入说明
```
page_size：number类型，可选（分页大小，默认10，最大50）
page_token：string类型，可选（翻页token，首次无需提供）
start_time：number类型，可选（邮件的起始时间戳（单位秒））
end_time：number类型，可选（邮件的结束时间戳（单位秒））
filter：array类型，可选（邮件筛选条件，字符串数组，可选值：unread（未读邮件）、flagged（星标邮件），例如：[\"unread\", \"flagged\"]）
```