cleanup-lists

Audit HubSpot lists and delete unused, empty, or duplicate entries.

58|16|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill cleanup-lists
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cleanup-lists
Source: https://github.com/TomGranot/hubspot-admin-skills/tree/main/skills/cleanup-lists
Command: npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill cleanup-lists

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit HubSpot lists to remove clutter. Unused lists slow down the UI, confuse team members, and can mask the lists that actually matter.

Core Features & Use Cases

  • Audit and identify unused, empty, or duplicate lists.
  • Cross-reference with workflows and campaigns to ensure safe deletions.
  • Generate a cleanup log and export list metadata to allow rollback if needed.

Quick Start

Run the cleanup-lists skill to scan all HubSpot lists, flag candidates for deletion, and apply a safe cleanup with an exportable rollback plan.

Frequently Asked Questions about cleanup-lists

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clean up unused HubSpot lists without breaking active campaigns?

To clean up HubSpot lists safely, the skill audits list definitions and cross-references their usage across workflows and campaigns before deletion. This ensures active marketing assets are preserved while removing unused, empty, or duplicate lists.

What is the best way to find and remove duplicate HubSpot lists?

The best way to find duplicate HubSpot lists is to run an automated audit that scans all list definitions and flags unused or empty lists for deletion. This removes clutter that slows down the UI and confuses team members.

Can I restore a HubSpot list after deleting it during a cleanup?

Yes, you can restore deleted lists because the cleanup process generates an exportable rollback plan with list metadata. This rollback plan allows you to recover the list if needed after applying the scoped cleanup.

Do I need Python to automate HubSpot list cleanup?

Yes, you need a Python environment to automate HubSpot list cleanup. The prerequisites include HubSpot API access, proper permissions, and a Python setup to execute the audit and produce the cleanup log.

Why should I purge empty HubSpot lists from my account?

You should purge empty HubSpot lists because unused lists slow down the user interface and confuse team members. Removing this clutter masks the lists that actually matter for your data hygiene and marketing operations.