2026.11.0
Home â–¸ Integrations

Tomorrow.io

The Tomorrow.io integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to obtain weather, air quality, pollen, and fire information from the Tomorrow.io API.

Obtain an API key

You can obtain a free API key by signing up with Tomorrow.io. The integration assumes that your API key is associated with a free Tomorrow.io account. Free accounts include a limited number of daily API requests and the number of daily API requests included varies by account. Log in to Tomorrow.io to view the number of daily API requests included with your account.

The refresh interval defaults to a time period that is compatible with an account limited to 100 daily API requests and this integration should use around 90% of the available daily requests.

When using a free account, the information provided by Tomorrow.io is limited to the Core layer. It does not include the Air Quality layer or other layers. A paid Tomorrow.io account is required to retrieve those layers.

Supported Forecast Types

Forecast Type Description
nowcast Up to the 1 minute predictions. Supports 300 minutes or a max of 30 forecasts depending on the chosen timestep
hourly Hourly forecasts for the next 24 hours
daily Daily forecasts for the next 14 days

Configuration

To add the Tomorrow.io service to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Tomorrow.io.

  • Follow the instructions on screen to complete the setup.

API key

Your Tomorrow.io API key.

The integration creates one entry per API key. The places you want weather and air quality data for are added to that entry as locations.

Note

If you set up Tomorrow.io before this version, your existing entries are migrated automatically: locations sharing an API key are collected under a single entry, and their entities, devices, and history are preserved.

Adding a location

  1. Go to Settings > Devices & services and select the Tomorrow.io integration.
  2. Select Add location.
  3. Enter a name and pick the location on the map.
  4. Optionally adjust Minutes between NowCast forecasts (1, 5, 15, 30, or 60), which controls the granularity of the nowcast forecast.

Changing a location

To change a location’s name, coordinates, or NowCast timestep, select the three-dot menu next to the location and select Reconfigure location.

Data updates

All of an API key’s locations are polledData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] together in one cycle. The polling interval is calculated from your account’s daily request limit and the number of configured locations, keeping usage at about 90% of the available daily requests.