HubSpot Email MCP Server

Instructions

Implementation Reference

• src/server.ts:118-139 (handler)

  The MCP tool handler that executes create_draft_email. It parses the request arguments using CreateDraftEmailSchema, calls the HubSpot client's createDraftEmail method, and returns a success message with the email ID, name, and subject.
  case 'create_draft_email': { const args = CreateDraftEmailSchema.parse(request.params.arguments); const result = await this.hubspot.createDraftEmail( args.name, args.subject, { htmlBody: args.htmlBody, content: args.content, from: args.from, subscriptionDetails: args.subscriptionDetails, to: args.to, } ); return { content: [ { type: 'text', text: `✅ メール下書きを作成しました\nID: ${result.id}\n名前: ${args.name}\n件名: ${args.subject}`, }, ], }; }
• src/hubspot/client.ts:58-91 (handler)

  The HubSpot API client implementation of createDraftEmail. Constructs the email data object with name, subject, emailType 'BATCH_EMAIL', and state 'DRAFT', then optionally adds htmlBody, content, from, subscriptionDetails, and to fields before calling the createEmail method.
  async createDraftEmail( name: string, subject: string, options?: { htmlBody?: string; content?: any; from?: any; subscriptionDetails?: any; to?: any; } ) { const data: any = { name, subject, emailType: 'BATCH_EMAIL', state: 'DRAFT', }; if (options?.htmlBody) { data.emailBody = options.htmlBody; } if (options?.content) { data.content = options.content; } if (options?.from) { data.from = options.from; } if (options?.subscriptionDetails) { data.subscriptionDetails = options.subscriptionDetails; } if (options?.to) { data.to = options.to; } return this.createEmail(data); }
• src/tools/types.ts:13-21 (schema)

  Zod schema definition for CreateDraftEmailSchema. Validates the input parameters including required fields (name, subject) and optional fields (htmlBody, content, from, subscriptionDetails, to).
  export const CreateDraftEmailSchema = z.object({ name: z.string().describe('メールキャンペーンの名前'), subject: z.string().describe('メールの件名'), htmlBody: z.string().optional().describe('HTMLメール本文（シンプルなメール用）'), content: z.any().optional().describe('メールコンテンツ構造（flexAreas, widgets等を含む詳細設定）'), from: z.any().optional().describe('送信者情報 { fromName, replyTo }'), subscriptionDetails: z.any().optional().describe('配信設定 { officeLocationId }'), to: z.any().optional().describe('送信先設定 { contactIlsLists, suppressGraymail }'), });
• src/server.ts:64-78 (registration)

  Tool registration in the MCP server's tools list. Defines the create_draft_email tool with its description and input schema including required fields (name, subject) and optional fields (htmlBody, content, from, subscriptionDetails, to).
  name: 'create_draft_email', description: 'メールの下書きを作成。既存メールを複製する場合はget_emailで取得したcontent等を渡す', inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'キャンペーン名' }, subject: { type: 'string', description: 'メール件名' }, htmlBody: { type: 'string', description: 'HTML本文（シンプルなメール用）' }, content: { type: 'object', description: 'メールコンテンツ構造（flexAreas, widgets等を含む詳細設定）' }, from: { type: 'object', description: '送信者情報 { fromName, replyTo }' }, subscriptionDetails: { type: 'object', description: '配信設定 { officeLocationId }' }, to: { type: 'object', description: '送信先設定 { contactIlsLists, suppressGraymail }' }, }, required: ['name', 'subject'], },
• src/hubspot/client.ts:42-47 (helper)

  Helper method createEmail that performs the actual POST request to HubSpot's /marketing/v3/emails endpoint with the provided data. Called by createDraftEmail after constructing the email data object.
  async createEmail(data: any) { return this.request('/marketing/v3/emails', { method: 'POST', body: JSON.stringify(data), }); }