Home Assistant

TappRFID integrates with Home Assistant across two separate components: a backend integration that exposes your tasks and logs as HA entities, and a Lovelace card that renders your task list in any HA dashboard. Both components have their own repository and can be installed independently.

Note

Both components require an active TappRFID cloud subscription. The integration communicates via the TappRFID cloud backend — local network only is not supported.

What you get

Backend integration

• Every task becomes a sensor entity with states: overdue, due_soon, on_track, complete
• Every log becomes a sensor entity with its last entry timestamp
• Rich attributes on each entity: streak, last completed, next due, interval
• Service calls to complete tasks, reopen tasks, and add log entries from automations or scripts

Lovelace card

• A custom card that renders your task list directly in a dashboard
• Uses the same visual language as the app — status dots, streaks, overdue highlighting
• Configurable to show specific tasks or all tasks
• Separate repo, installs independently from the backend integration

Requirements

• TappRFID cloud subscription (trial or paid)
• Cloud account connected and sync active in the app — see Cloud Sync
• Home Assistant 2023.4 or later
• HACS installed (recommended) — hacs.xyz

Repositories

Component	Repository
Backend integration	github.com/mrcpuddington/tap-home-assistant-integration
Lovelace card	github.com/mrcpuddington/tap-home-assistant-card

Which page do I need?

I want to…	Go to…
Expose task/log status as HA sensor entities	Backend Integration
Complete tasks from automations or dashboards	Backend Integration
Show my task list in an HA dashboard card	Lovelace Card
See automation YAML examples and patterns	Automations

Architecture overview

TappRFID app (iOS)
      ↕  cloud sync
TappRFID cloud backend
      ↕  OAuth + REST polling
Home Assistant integration  →  sensor entities
                            →  service calls
                            ↓
                     Lovelace card  →  dashboard tiles

The HA integration polls the TappRFID cloud for updates. Changes you make in the app appear in HA within seconds. Service calls (completing tasks, adding log entries) go through the cloud and sync back to the app.