markAsUnread
Mark specific email messages as unread in your inbox to track them for follow-up or review. Use this tool to manage email status by providing the message UID and optional folder name.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | ||
| folder | No | INBOX |
Implementation Reference
- src/tools/mail.ts:1167-1199 (registration)MCP tool registration for 'markAsUnread', including Zod input schema {uid: number, folder?: string}, handler function that calls MailService.markAsUnread and returns formatted response.this.server.tool( "markAsUnread", { uid: z.number(), folder: z.string().default('INBOX') }, async ({ uid, folder }) => { try { const numericUid = Number(uid); const success = await this.mailService.markAsUnread(numericUid, folder); if (success) { return { content: [ { type: "text", text: `邮件(UID: ${uid})已标记为未读` } ] }; } else { return { content: [ { type: "text", text: `标记邮件(UID: ${uid})为未读失败` } ] }; } } catch (error) { return { content: [ { type: "text", text: `标记邮件为未读时发生错误: ${error instanceof Error ? error.message : String(error)}` } ] }; } } );
- src/tools/mail-service.ts:545-567 (helper)MailService method that implements the core logic: opens IMAP box and removes the \\Seen flag from the specified email UID using delFlags.async markAsUnread(uid: number | string, folder: string = 'INBOX'): Promise<boolean> { await this.connectImap(); // 确保 uid 为数字类型 const numericUid = 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(numericUid, '\\Seen', (err) => { if (err) { reject(err); return; } resolve(true); }); }); }); }