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);
      });
    });
  });
}

Mail MCP Tool