Email MCP Server

Instructions

Implementation Reference

• src/tools/DeleteMessageTool.ts:14-22 (handler)

  The execute function implementing the 'deleteMessage' tool logic. Validates args, gets IMAP controller, connects, deletes message by folder and UID, returns success.

  async execute(args, context) {
    if (!args || typeof args !== 'object' || !('folder' in args) || !('uid' in args)) {
      throw new Error("Missing required arguments");
    }
    const controller = ImapControllerFactory.getInstance();
    await controller.connect();
    await controller.deleteMessage(args.folder, args.uid);
    return JSON.stringify({ success: true });
  }

• src/tools/DeleteMessageTool.ts:5-8 (schema)

  Zod schema defining input parameters for deleteMessage tool: folder (string) and uid (number).

  export const DeleteMessageInput = z.object({
    folder: z.string().min(2).max(100),
    uid: z.number()
  });

• src/index.ts:49-49 (registration)

  Registration of the DeleteMessageTool with the MCP server.

  server.addTool(DeleteMessageTool);

• src/controllers/ImapController.ts:251-264 (helper)

  Helper method in ImapController that opens the folder, adds \Deleted flag to the message by UID, and expunges it.

  deleteMessage(folder: string, uid: number): Promise<void> {
      return new Promise((resolve, reject) => {
          this.imap.openBox(folder, false, (err: Error | null, box: Imap.Box | null) => {
              if (err) return reject(err);
              this.imap.addFlags(uid, '\\Deleted', (err: Error | null) => {
                  if (err) return reject(err);
                  this.imap.expunge(uid, (err: Error | null) => {
                      if (err) return reject(err);
                      resolve();
                  });
              });
          });
      });
  }