mail_create_message

Instructions

Implementation Reference

• src/index.ts:1930-1997 (handler)

  The handler logic for the 'mail_create_message' tool. It validates input parameters (to, subject, body, optional cc), constructs an AppleScript command using osascript to create a new outgoing message in the Mail app, executes it, and returns the result or error.

  case 'mail_create_message':
    try {
      const to = (args?.to as string) || '';
      const subject = (args?.subject as string) || '';
      const body = (args?.body as string) || '';
      const cc = (args?.cc as string) || '';
      
      if (!to || !subject || !body) {
        return {
          content: [
            {
              type: 'text',
              text: 'Error: to, subject, and body are required',
            },
          ],
        };
      }
      
      const command = `osascript -e 'on run argv
        set toAddress to item 1 of argv
        set mailSubject to item 2 of argv
        set mailBody to item 3 of argv
        set ccAddress to item 4 of argv
        
        tell application "Mail"
          set newMessage to make new outgoing message
          set subject of newMessage to mailSubject
          set content of newMessage to mailBody
          make new to recipient at end of to recipients of newMessage with properties {address:toAddress}
          if ccAddress is not "" then
            make new cc recipient at end of cc recipients of newMessage with properties {address:ccAddress}
          end if
          return "Message created - Subject: " & subject of newMessage & ", To: " & toAddress
        end tell
      end run' -- "${to}" "${subject}" "${body}" "${cc}"`;
      
      const { stdout, stderr } = await execAsync(command);
      
      if (stderr.trim()) {
        return {
          content: [
            {
              type: 'text',
              text: `Error creating message: ${stderr.trim()}`,
            },
          ],
        };
      }
      
      return {
        content: [
          {
            type: 'text',
            text: stdout.trim(),
          },
        ],
      };
    } catch (error: any) {
      return {
        content: [
          {
            type: 'text',
            text: `Error executing mail create command: ${error.message}`,
          },
        ],
      };
    }

• src/index.ts:297-321 (registration)

  Registration of the 'mail_create_message' tool in the ListTools handler, including its name, description, and input schema definition.

    name: 'mail_create_message',
    description: 'Create new email message with recipients, subject, and body',
    inputSchema: {
      type: 'object',
      properties: {
        to: {
          type: 'string',
          description: 'Recipient email address',
        },
        subject: {
          type: 'string',
          description: 'Email subject',
        },
        body: {
          type: 'string',
          description: 'Email body content',
        },
        cc: {
          type: 'string',
          description: 'CC recipient email address (optional)',
        },
      },
      required: ['to', 'subject', 'body'],
    },
  },

• src/index.ts:297-321 (schema)

  Input schema definition for the 'mail_create_message' tool, specifying properties and required fields.

    name: 'mail_create_message',
    description: 'Create new email message with recipients, subject, and body',
    inputSchema: {
      type: 'object',
      properties: {
        to: {
          type: 'string',
          description: 'Recipient email address',
        },
        subject: {
          type: 'string',
          description: 'Email subject',
        },
        body: {
          type: 'string',
          description: 'Email body content',
        },
        cc: {
          type: 'string',
          description: 'CC recipient email address (optional)',
        },
      },
      required: ['to', 'subject', 'body'],
    },
  },