HubSpot Email

You can manage HubSpot Marketing Email assets from Claude Desktop using this MCP server. It lets you list emails, view details, create drafts, and update existing emails without sending anything. This keeps your workflow integrated while preventing accidental sends.

How to use

Use an MCP client to interact with the HubSpot Email MCP Server. You can:

• List marketing emails to see what exists and when they were created
• Retrieve details for a specific email to review subject, body, and settings
• Create email drafts to begin new campaigns without sending anything yet
• Update existing emails to refine drafts or adjust metadata Start by authenticating with your HubSpot access token as described in the setup steps, then issue requests via your MCP client to the server name you configured (hubspot_email). You will perform these actions through natural language prompts like: “Create a newsletter draft in HubSpot” followed by details, or “Show me the list of emails created last week.” Ensure you never trigger actual sends from this server.

How to install

Prerequisites you need:
- Node.js and npm installed on your machine
- Access to a HubSpot account and a valid HubSpot Access Token
- Claude Desktop installed on your computer to run the MCP server through a local configuration

Follow these steps exactly to set up the HubSpot Email MCP Server.

Configuration and security

1) Install dependencies and build the MCP package
2) Create or configure the MCP entry in Claude Desktop to point to the local MCP server via npx and specify your HubSpot access token
3) Restart Claude Desktop to apply the new MCP server configuration

Important: Treat the HubSpot Access Token as a secret. Do not expose it in logs or shared configurations. The token is used to authorize API calls to HubSpot for marketing email management.

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

Testing and troubleshooting

Test the server using the MCP Inspector or your MCP client to ensure proper communication. Verify that the HUBSPOT_ACCESS_TOKEN is correctly set in the environment where the inspector runs. If you encounter authentication errors, regenerate the token with the required scope and update the environment variable accordingly. If the server appears unresponsive, restart Claude Desktop to reload the MCP configuration.

Available tools

listEmails

Retrieve a list of marketing emails stored in HubSpot.

getEmailDetails

Fetch detailed information for a specific email by its ID.

createEmailDraft

Create a new email draft in HubSpot for further editing before sending.

updateEmail

Update fields of an existing HubSpot marketing email draft or template.