Support

Contact: Email huxleybuilds@gmail.com. Replies usually within 2 business days.

Please include your Stream Deck model, your OS, and what the key shows.

Setup

1. Install Task Timer for ClickUp from the Elgato Marketplace.
2. In Stream Deck, drag Task Timer (under the "Task Timer for ClickUp" category) onto a key, or onto a dial on Stream Deck +.
3. Get your token from ClickUp:
   1. Open ClickUp (web or desktop) and click your avatar (bottom-left, or top-right in some layouts).
   2. Choose Settings, then Apps in the left sidebar. You can also click Open page in the plugin settings, which opens https://app.clickup.com/settings/apps.
   3. Under API Token, click Generate (or Copy if you already have one). Tokens start with pk_.
4. Back in Stream Deck, paste the token into API key. The plugin checks it right away and shows "Connected as your name". You only do this once, because every key shares the token.
5. Pick a Workspace, then a List, then a Task. Use Find task to filter long lists.
6. Press the key: the timer starts in ClickUp and the key counts up. Press again to stop.

Stream Deck +: choose a workspace and list. Turn the dial to scroll through the list's open tasks, and press the dial (or tap the touch strip) to start or stop.

Running Timer key: choose a workspace. The key shows whatever timer is running. Press to stop it, or press again to resume the last task.

To remove the token, click Remove key in the settings. You can also regenerate the token in ClickUp, which revokes the old one immediately.

FAQ

Does it work on ClickUp's free plan? Yes. Time tracking on tasks is available on every ClickUp plan, and the plugin only creates task-linked time entries.

Is this an official ClickUp plugin? No. It's an independent plugin that uses ClickUp's public API. It's not affiliated with, endorsed by or sponsored by ClickUp.

The key says "Add API key" or "Check API key". Open the action's settings, then paste a fresh token from ClickUp (Settings → Apps → API Token) and wait for "Connected as …". If you regenerated your token in ClickUp, the old one stops working right away.

I started a timer in ClickUp, but the key didn't change straight away. The plugin checks ClickUp every 15 seconds, so changes made elsewhere show up within about 15 s. Presses on the key are applied immediately.

Pressing one key stopped another key's timer. ClickUp allows one running timer per person, and starting a new task stops the previous one, just as it does in ClickUp itself. Keys for other tasks show a small amber dot while a different task is being tracked.

The key flashed a warning triangle. The request failed. Usually you're offline, ClickUp rate-limited the token (100 requests a minute on most plans; the plugin backs off automatically), or the task was deleted or closed. Try again in a moment, or pick the task again.

My task isn't in the list. Only open tasks are shown, including subtasks. Click Refresh lists after creating new tasks, and use Find task to filter.

What does the dial do on Stream Deck +? Turn it to step through the open tasks in the chosen list. Press it or tap the touch strip to start or stop the selected task.

Can several keys share one token? Yes. The token is stored once for the whole plugin, and every key and dial uses it.

Does it work in Multi Actions? Yes. A Task Timer inside a Multi Action toggles that task's timer.

Which data leaves my computer? Only requests to api.clickup.com. See the privacy note: https://tasktimer-clickup.level8realestate.workers.dev/privacy

Refunds and support Email huxleybuilds@gmail.com. Replies usually within 2 business days.