iMail-mcp

Instructions

Implementation Reference

• src/lib/icloud-mail-client.ts:355-381 (handler)

  Core handler function that executes the email sending logic using nodemailer Transporter via iCloud SMTP.
  async sendEmail(options: SendEmailOptions): Promise<{ messageId: string }> { const mailOptions: nodemailer.SendMailOptions = { from: this.config.email, to: options.to, subject: options.subject, }; if (options.text) { mailOptions.text = options.text; } if (options.html) { mailOptions.html = options.html; } if (options.attachments) { mailOptions.attachments = options.attachments.map((att) => ({ filename: att.filename, path: att.path, content: att.content, contentType: att.contentType, })); } const info = await this.transporter.sendMail(mailOptions); return { messageId: info.messageId }; }
• src/index.ts:419-442 (handler)

  MCP server request handler that processes 'send_email' tool calls and delegates to iCloudMailClient.sendEmail.
  case 'send_email': { if (!mailClient) { throw new McpError( ErrorCode.InvalidRequest, 'iCloud Mail not configured. Please set ICLOUD_EMAIL and ICLOUD_APP_PASSWORD environment variables.' ); } const result = await mailClient.sendEmail({ to: args?.to as string | string[], subject: args?.subject as string, text: args?.text as string, html: args?.html as string, }); return { content: [ { type: 'text', text: `Email sent successfully. Message ID: ${result.messageId}`, }, ], }; }
• src/index.ts:81-109 (registration)

  Registers the 'send_email' tool in the MCP ListTools response with name, description, and input schema.
  { name: 'send_email', description: 'Send an email through iCloud Mail', inputSchema: { type: 'object', properties: { to: { oneOf: [ { type: 'string' }, { type: 'array', items: { type: 'string' } }, ], description: 'Recipient email address(es)', }, subject: { type: 'string', description: 'Email subject', }, text: { type: 'string', description: 'Plain text email body', }, html: { type: 'string', description: 'HTML email body', }, }, required: ['to', 'subject'], }, },
• src/types/config.ts:28-39 (schema)

  TypeScript interface defining the input parameters for the sendEmail function.
  export interface SendEmailOptions { to: string | string[]; subject: string; text?: string; html?: string; attachments?: Array<{ filename: string; path?: string; content?: Buffer; contentType?: string; }>; }