markMultipleAsRead
Mark multiple email messages as read in a specified folder using unique identifiers to manage inbox status efficiently.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uids | Yes | ||
| folder | No | INBOX |
Implementation Reference
- src/tools/mail.ts:1068-1093 (handler)The inline handler function for the MCP tool 'markMultipleAsRead'. It validates inputs, calls the mail service to mark emails as read, and returns a success or error message.async ({ uids, folder }) => { try { const numericUids = uids.map(uid => Number(uid)); const success = await this.mailService.markMultipleAsRead(numericUids, folder); if (success) { return { content: [ { type: "text", text: `已将 ${uids.length} 封邮件标记为已读` } ] }; } else { return { content: [ { type: "text", text: `批量标记邮件为已读失败` } ] }; } } catch (error) { return { content: [ { type: "text", text: `批量标记邮件为已读时发生错误: ${error instanceof Error ? error.message : String(error)}` } ] }; } }
- src/tools/mail.ts:1064-1067 (schema)Zod schema defining the input parameters for the 'markMultipleAsRead' tool: array of numeric UIDs and optional folder.{ uids: z.array(z.number()), folder: z.string().default('INBOX') },
- src/tools/mail.ts:1062-1094 (registration)Registration of the 'markMultipleAsRead' tool on the MCP server, including schema and handler.this.server.tool( "markMultipleAsRead", { uids: z.array(z.number()), folder: z.string().default('INBOX') }, async ({ uids, folder }) => { try { const numericUids = uids.map(uid => Number(uid)); const success = await this.mailService.markMultipleAsRead(numericUids, folder); if (success) { return { content: [ { type: "text", text: `已将 ${uids.length} 封邮件标记为已读` } ] }; } else { return { content: [ { type: "text", text: `批量标记邮件为已读失败` } ] }; } } catch (error) { return { content: [ { type: "text", text: `批量标记邮件为已读时发生错误: ${error instanceof Error ? error.message : String(error)}` } ] }; } } );
- src/tools/mail-service.ts:1068-1090 (helper)Helper method in MailService class that performs the actual IMAP operation to mark multiple emails as read by adding the \Seen flag.async markMultipleAsRead(uids: (number | string)[], folder: string = 'INBOX'): Promise<boolean> { await this.connectImap(); // 确保所有 uid 都是数字类型 const numericUids = uids.map(uid => typeof uid === 'string' ? parseInt(uid, 10) : uid); return new Promise((resolve, reject) => { this.imapClient.openBox(folder, false, (err) => { if (err) { reject(err); return; } this.imapClient.addFlags(numericUids, '\\Seen', (err) => { if (err) { reject(err); return; } resolve(true); }); }); }); }