HubSpot Email MCP Server

A Model Context Protocol (MCP) server for the HubSpot Marketing Email API. Manage HubSpot marketing emails from Claude Desktop.

日本語版 README

Features

• List marketing emails
• Get email details
• Create email drafts
• Update emails

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

Setup

1. Install Dependencies

npm install

2. Get HubSpot Access Token

1. Log in to your HubSpot account
2. Go to Development > Legacy Apps (開発 > 旧アプリ)
3. Create a new app
4. Set the required scopes: content (for Marketing Emails)
5. Copy the Access Token (pat-na1-... format)

3. Build

npm run build

4. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

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

5. Restart Claude Desktop

Restart Claude Desktop completely to apply the settings.

Usage

You can use it in Claude Desktop like this:

"Create a newsletter draft in HubSpot.
Subject: New Product Announcement
Body: We have released a new version of Product A"

"Show me the list of emails created last week"

"Check the content of email ID 12345"

Development

Testing with MCP Inspector

You can test the MCP server using the official inspector tool:

npx @modelcontextprotocol/inspector npx -y /path/to/hubspot-email-mcp

Set the HUBSPOT_ACCESS_TOKEN environment variable in the inspector UI to test with your HubSpot account.

Local Testing

npm run dev

Build

npm run build

License

MIT