Claude와 함께 HubSpot 마케팅 이메일을 만들기 위해 MCP 서버를 구축했습니다

Source: Dev.to

Introduction

정기적으로 뉴스레터를 만드는 일은 생각보다 시간이 많이 듭니다: HubSpot에 로그인하고, 템플릿을 선택하고, 제목을 고민하고, 본문을 작성하는 과정이 모두 반복됩니다. 이 반복 작업을 AI에게 맡기고 싶어 Model Context Protocol (MCP) 서버를 구축했습니다. 이 서버를 통해 Claude가 HubSpot 마케팅 이메일 API와 직접 상호작용할 수 있습니다. 프로젝트는 GitHub에 오픈소스로 공개되어 있습니다.

Features

• 마케팅 이메일 목록 조회
• 이메일 상세 정보 가져오기
• 이메일 초안 만들기
• 기존 이메일 업데이트

Note: The server does not include email‑sending functionality to prevent accidental sends.

Setup

1. Install dependencies

   npm install

2. Get a HubSpot access token

   • HubSpot 계정에 로그인합니다.
   • Development > Legacy Apps (開発 > 旧アプリ) 로 이동합니다.
   • 새 앱을 만들고 필요한 스코프를 설정합니다: content (마케팅 이메일용).
   • 생성된 액세스 토큰을 복사합니다 (형식 pat-na1-…).

3. Build the server

   npm run build

4. Configure Claude Desktop

   ~/Library/Application Support/Claude/claude_desktop_config.json 파일을 편집하고 MCP 서버 정의를 추가합니다:

   {
     "mcpServers": {
       "hubspot-email": {
         "command": "npx",
         "args": ["-y", "/path/to/hubspot-email-mcp"],
         "env": {
           "HUBSPOT_ACCESS_TOKEN": "your-access-token"
         }
       }
     }
   }

5. Restart Claude Desktop

   설정을 저장한 뒤 Claude Desktop을 재시작하여 새로운 MCP 서버를 로드합니다.

Usage

MCP 서버가 실행 중이면 Claude Desktop과 대화하듯 HubSpot을 조작할 수 있습니다.

• Create a newsletter

  Create a newsletter in HubSpot announcing our new product.
  Subject: Introducing Product A
  Body: We're excited to announce the release of Product A...

• List recent emails

  Show me the emails I created last week.

• Check an email’s content

  Check the content of email ID 12345.

Claude가 백그라운드에서 MCP 서버를 호출해 요청된 작업을 수행합니다. 초안이 준비되면 HubSpot 대시보드에서 최종 검토 후 직접 이메일을 전송합니다.

Future Plans

WordPress 연동을 추가할 계획입니다. 이를 통해 게시된 블로그 포스트가 자동으로 뉴스레터 초안을 생성하도록 할 수 있습니다:

“블로그 포스트를 발행하면, 이미 준비된 뉴스레터 초안이 기다리고 있습니다.”

이렇게 하면 콘텐츠 마케팅을 위한 완전 자동 워크플로우가 구축되어 운영 부담이 크게 줄어듭니다.

Repository

소스 코드, 자세한 설정 방법 및 추가 문서는 GitHub에서 확인할 수 있습니다:

hubspot-email-mcp

프로젝트가 유용하다고 생각되시면 저장소에 ⭐️를 눌러 주세요!