Skip to content

schneik80/PowerTools-PlusProject

Repository files navigation

PowerTools – Plus Project

PowerTools Plus Project is an Autodesk Fusion add-in that connects your design projects to ClickUp, a cloud-based project management platform. Map any Fusion project to a ClickUp task list, open that list with a single click, and create or update ClickUp tasks without leaving the design environment.

PowerTools Plus Project toolbar panel


Commands

Command Location Purpose
Set ClickUp Tokens QAT › PowerTools Settings Store your ClickUp and TinyURL API credentials
Map Project to ClickUp QAT › PowerTools Settings Link the active Fusion project to a ClickUp list
Open ClickUp Design workspace › PowerTools panel Open the mapped ClickUp list in your browser
Add ClickUp Task Design workspace › PowerTools panel Create a new ClickUp task from within Fusion
List Tasks Design workspace › PowerTools panel View tasks linked to the active document and the full project list
Update Tasks Design workspace › PowerTools panel Edit task name, due date, and priority for tasks linked to the active document

Installation

  1. Download or clone this repository.
  2. In Autodesk Fusion, open the Scripts and Add-Ins dialog (keyboard shortcut: Shift+S).
  3. Select the Add-Ins tab, then select the + icon and browse to the repository folder.
  4. Select PowerTools-PlusProject and select Run.

The add-in loads the PowerTools panel into the Design workspace toolbar and adds a PowerTools Settings flyout to the Quick Access Toolbar (QAT).


First-time setup

Complete these two steps before using the toolbar commands.

1. Set API tokens

Run Set ClickUp Tokens from QAT › PowerTools Settings and enter your credentials:

2. Map each Fusion project

For each Fusion project you want to connect to ClickUp:

  1. Open any saved document that belongs to the project.
  2. Run Map Project to ClickUp from QAT › PowerTools Settings.
  3. Enter the ClickUp list URL and List ID for that project.

Repeat this step for each Fusion project you want to connect.


Typical workflow

  1. Create a corresponding ClickUp list for each Fusion project you want to track.
  2. Run Map Project to ClickUp once per project to store the list URL and List ID.
  3. While working in Fusion, use Open ClickUp to jump directly to the task list in your browser.
  4. Use Add ClickUp Task to log new tasks. Optionally link the active Fusion document so teammates can open it directly from ClickUp.
  5. Use List Tasks to review all tasks linked to the active document or the full project list.
  6. Use Update Tasks to edit task name, due date, or priority without leaving Fusion.

System architecture

The following diagram shows the high-level relationships between the add-in, Autodesk Fusion, the local cache, and the external services.

C4Context
    title PowerTools Plus Project — System Context Diagram

    Person(user, "Designer", "Autodesk Fusion user who manages design-related tasks in ClickUp")

    System_Boundary(addin_boundary, "PowerTools Plus Project Add-in") {
        System(addin, "PowerTools Plus Project", "Fusion add-in that bridges the design environment and the ClickUp project management platform")
    }

    System(fusion, "Autodesk Fusion", "CAD host application; provides document and project context to the add-in")
    SystemDb(cache, "Local Cache", "auth.json + projects.json — stores API credentials and project-to-list mappings on the local file system")
    System_Ext(clickup, "ClickUp API v2", "Cloud-based project management platform; receives and returns task data")
    System_Ext(tinyurl, "TinyURL API", "URL shortening service; used when attaching Fusion document deep links to tasks")
    System_Ext(browser, "Web Browser", "Default system browser; opened by the Open ClickUp command")

    Rel(user, addin, "Uses commands in the Fusion toolbar and QAT")
    Rel(addin, fusion, "Reads active document identity and project URN")
    Rel(addin, cache, "Reads and writes API tokens and project mappings")
    Rel(addin, clickup, "Creates, reads, and updates tasks via REST API")
    Rel(addin, tinyurl, "Shortens fusion360:// deep-link URLs (optional)")
    Rel(addin, browser, "Opens ClickUp list URLs on demand")
Loading

Requirements

  • Autodesk Fusion — any current subscription tier
  • A ClickUp account with API access
  • A TinyURL account with API access (optional — required only for document linking)

Documentation

Full command reference is in the docs/ folder.

Document Description
Set ClickUp Tokens Store API credentials for ClickUp and TinyURL
Map Project to ClickUp Link a Fusion project to a ClickUp list
Open ClickUp Open the mapped ClickUp list in the browser
Add ClickUp Task Create a task from within Fusion
List Tasks View document and project tasks
Update Tasks Edit task details from within Fusion
Creating the Fusion Design Custom Field Set up the ClickUp URL field for document linking

Cache files

The add-in stores runtime data locally in cache/ at the add-in root. These files are excluded from source control and must not be shared.

File Contents
cache/auth.json ClickUp and TinyURL API tokens
cache/projects.json Fusion project URN → ClickUp list mappings

Warning

cache/auth.json contains API tokens stored in plain text. Do not share this file or commit it to a repository.


Support

This add-in is developed and maintained by IMA LLC.


License

This project is released under the GNU General Public License v3.0 or later.

Copyright (C) 2022-2026 IMA LLC.

The shared library at lib/fusionAddInUtils is vendored byte-for-byte identically across all nine PowerTools add-ins. It mixes code under different terms: general_utils.py, event_utils.py, and attributes_utils.py are based on Autodesk, Inc. sample code (distributed under its own license terms — see the source headers); cache_utils.py, date_utils.py, log_utils.py, and upload_utils.py are part of this project (IMA LLC, GPL-3.0-or-later). See each module's source header for details.


Copyright © 2026 IMA LLC. All rights reserved.

About

Access additional tools in your fusion projects to track tasks and work. Add-in allows linking Fusion projects to external project management services.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

 
 
 

Contributors

Languages