HubspotUsersApi

The HubspotUsersApi MCP Server provides a comprehensive set of tools for managing users and teams within a HubSpot account. With this server, users can:

• Retrieve lists of users, teams, and roles associated with the account.
• Create new users with basic permissions.
• Update user information and manage user accounts.
• Remove users from the HubSpot system as needed.

This server streamlines user management and enhances team collaboration within HubSpot.

Available Tools

HubspotUsersApi.ViewAccountTeams

Retrieve all teams for the account.

Parameters

This tool does not take any parameters.

HubspotUsersApi.GetAccountRoles

Retrieve all user roles from an account.

Parameters

This tool does not take any parameters.

HubspotUsersApi.FetchHubspotUsersList

Retrieve a list of users from a HubSpot account.

Parameters

• page_cursor_after (string, optional) A string token used to retrieve the next page of users, if more than 100 users are available.
• user_retrieval_limit (integer, optional) Specify the maximum number of users to retrieve from the HubSpot account.

HubspotUsersApi.CreateHubspotUser

Create a new user in HubSpot with basic permissions.

Parameters

• user_email (string, required) The email address of the user to be created in HubSpot.
• additional_team_ids (array[string], optional) List of IDs representing the user’s additional teams.
• last_name (string, optional) The last name of the user to be created in HubSpot.
• primary_team_id (string, optional) The identifier for the user’s primary team in HubSpot.
• send_welcome_email (boolean, optional) Set to true to send a welcome email prompting the user to set a password and log in.
• user_first_name (string, optional) The first name of the user to be created in HubSpot.
• user_role_id (string, optional) A string representing the new user’s role within HubSpot.

HubspotUsersApi.RetrieveHubspotUserById

Retrieve Hubspot user details using user ID or email.

Parameters

• user_identifier (string, required) Identifier of the Hubspot user to retrieve. It can be the user ID or email based on the id_property.
• user_identifier_property (string, optional) Specifies the property to identify the user: USER_ID (default) or EMAIL.

HubspotUsersApi.UpdateHubspotUserInfo

Update information for a specified Hubspot user.

Parameters

• user_identifier (string, required) The unique identifier for the user. Can be the user’s ID or email, based on the id_property.
• additional_teams_ids (array[string], optional) An array of strings representing the IDs of the user’s additional teams.
• first_name (string, optional) The first name of the user to update. This should be a string value.
• last_name (string, optional) The last name of the user to be modified. This is the new value of the user’s last name.
• user_identifier_property (string, optional) Specifies if the user is identified by ‘USER_ID’ or ‘EMAIL’. Default is ‘USER_ID’.
• user_primary_team_id (string, optional) The unique ID for the user’s primary team.
• user_role_id (string, optional) The ID representing the user’s role. Used to assign the user a specific role within the system.

HubspotUsersApi.RemoveUserHubspot

Remove a user from HubSpot using their ID or email.

Parameters

• user_identifier (string, required) Identifier of the user to remove from HubSpot. It can be a user ID or an email address.
• user_identifier_property (string, optional) Specify whether to use USER_ID or EMAIL to identify the user.

Auth

The HubspotUsersApi MCP Server uses the Auth Provider with id arcade-hubspot to connect to users’ HubspotUsersApi accounts. In order to use the MCP Server, you will need to configure the arcade-hubspot auth provider.

pip install arcade_hubspot_users_api