Mail MCP Tool

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')
  },