iMail-mcp

Instructions

Implementation Reference

• src/index.ts:507-526 (handler)

  MCP tool handler for 'create_mailbox'. Validates client configuration, extracts 'name' parameter, invokes mailClient.createMailbox(), and returns result as formatted JSON.

  case 'create_mailbox': {
    if (!mailClient) {
      throw new McpError(
        ErrorCode.InvalidRequest,
        'iCloud Mail not configured. Please set ICLOUD_EMAIL and ICLOUD_APP_PASSWORD environment variables.'
      );
    }
  
    const mailboxName = args?.name as string;
    const result = await mailClient.createMailbox(mailboxName);
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/index.ts:146-159 (registration)

  Registers the 'create_mailbox' tool in the ListTools response with description and input schema requiring a 'name' string.

  {
    name: 'create_mailbox',
    description: 'Create a new mailbox (folder)',
    inputSchema: {
      type: 'object',
      properties: {
        name: {
          type: 'string',
          description: 'Name of the mailbox to create',
        },
      },
      required: ['name'],
    },
  },

• src/index.ts:149-158 (schema)

  Input schema definition for 'create_mailbox' tool, specifying an object with required 'name' property of type string.

  inputSchema: {
    type: 'object',
    properties: {
      name: {
        type: 'string',
        description: 'Name of the mailbox to create',
      },
    },
    required: ['name'],
  },

• src/lib/icloud-mail-client.ts:417-436 (helper)

  iCloudMailClient helper method implementing mailbox creation via IMAP addBox, returning success/error status with message.

  async createMailbox(
    name: string
  ): Promise<{ status: string; message: string }> {
    return new Promise((resolve) => {
      this.imap.addBox(name, (err: Error) => {
        if (err) {
          resolve({
            status: 'error',
            message: err.message,
          });
          return;
        }
  
        resolve({
          status: 'success',
          message: `Mailbox '${name}' created successfully`,
        });
      });
    });
  }