git404hub

what is ha-super-productivity fr?

jloops412/ha-super-productivity — explained in plain English

Analysis updated 2026-05-18

5PythonAudience · ops devopsComplexity · 3/5Setup · moderate

tl;dr

A two way bridge between the Super Productivity task app and Home Assistant, letting tasks control smart home devices and vice versa.

vibe map

mindmap
  root((HA Bridge))
    What it does
      Syncs tasks to HA
      Rules engine in SP
      Two way automation
    Tech stack
      Home Assistant
      HACS
      Python
    Use cases
      Auto adjust lighting
      Pomodoro reminders
      Voice task creation
    Audience
      Home Assistant users
      Productivity enthusiasts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Automatically change your smart lights when you start or stop a focused work session.

VIBE 2

Get a spoken Pomodoro break reminder announced through a smart speaker.

VIBE 3

Create and manage Super Productivity tasks directly from a Home Assistant dashboard.

VIBE 4

Trigger a celebration scene, sound, or notification when all of today's tasks are completed.

what's the stack?

PythonHome AssistantHACS

how it stacks up fr

jloops412/ha-super-productivity1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audienceops devopsops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires the Super Productivity desktop app with its local REST API enabled, plus Home Assistant on the same local network.

No license information was included in the README excerpt.

in plain english

This project connects two separate apps together: Super Productivity, a task and time tracking app, and Home Assistant, a smart home platform. It works in both directions, so your task list can control your smart home, and your smart home can be controlled based on what you are working on. There are two pieces that make this work. The first is a Home Assistant integration, which pulls your tasks, active project, and time tracking status into Home Assistant as sensors, todo lists, buttons, and a calendar, so you can see and manage your work from a smart home dashboard. The second is a plugin that runs inside Super Productivity itself, which lets you build automation rules that react to what you are doing, such as starting a task, finishing all of today's tasks, or being idle for a set number of minutes. With these rules, you can do things like automatically change your lights when you start focused work, get a spoken reminder when a Pomodoro break should start, have your smart speaker announce something when a task is finished, or trigger any Home Assistant scene, automation, or script from inside Super Productivity. The integration also lets you create tasks by voice using Home Assistant's Assist feature, and it fires events whenever a task starts, stops, or completes, which other Home Assistant automations can listen for. Setup involves installing the integration through HACS, the Home Assistant Community Store, then pointing it at your Super Productivity desktop app's local address with its REST API turned on. Separately, you install the plugin inside Super Productivity and connect it to Home Assistant using a long lived access token, which the plugin stores securely rather than saving it in a way that could sync to backups or exports. The repository also includes an example dashboard layout you can copy to get a ready made productivity view. This project is aimed at people who already use both Super Productivity and Home Assistant and want their work habits and their home environment to respond to each other, such as smart home enthusiasts who also do focused deep work sessions.

prompts (copy fr)

prompt 1
Walk me through installing this integration via HACS and connecting it to my Super Productivity app.
prompt 2
Explain how the Super Productivity plugin sends events to Home Assistant through a webhook.
prompt 3
Help me write a rule that dims my lights when I start tracking a coding task.
prompt 4
Show me how to set up the example dashboard_cards.yaml layout from this repository.
prompt 5
What Home Assistant services does this integration expose for creating and completing tasks?

Frequently asked questions

what is ha-super-productivity fr?

A two way bridge between the Super Productivity task app and Home Assistant, letting tasks control smart home devices and vice versa.

What language is ha-super-productivity written in?

Mainly Python. The stack also includes Python, Home Assistant, HACS.

What license does ha-super-productivity use?

No license information was included in the README excerpt.

How hard is ha-super-productivity to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ha-super-productivity for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.