markMultipleAsUnread
Mark multiple email messages as unread in a specified folder to maintain inbox organization and track messages requiring follow-up.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uids | Yes | ||
| folder | No | INBOX |
Implementation Reference
- src/tools/mail-service.ts:1095-1117 (handler)The core handler function in MailService that marks multiple emails as unread by removing the IMAP '\Seen' flag from the specified UIDs in the given folder.async markMultipleAsUnread(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.delFlags(numericUids, '\\Seen', (err) => { if (err) { reject(err); return; } resolve(true); }); }); }); }
- src/tools/mail.ts:1097-1129 (registration)MCP tool registration for 'markMultipleAsUnread', including input schema validation with Zod and a wrapper handler that delegates to MailService.markMultipleAsUnread.this.server.tool( "markMultipleAsUnread", { 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.markMultipleAsUnread(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:1099-1102 (schema)Zod schema defining the input parameters for the 'markMultipleAsUnread' tool: array of numeric UIDs and optional folder (defaults to 'INBOX').{ uids: z.array(z.number()), folder: z.string().default('INBOX') },