Smart Home Integration

PrayCalc connects to major smart home platforms so you can ask for prayer times by voice, automate lights around salah, and play adhan on smart speakers.

Overview

PrayCalc Smart supports four platforms:

Free tier users get 5 voice queries per day. Ummat+ subscribers ($9.99/year) get unlimited queries across all platforms.

Google Home

Setup

1. Open the Google Home app on your phone
2. Tap Settings then Works with Google
3. Search for PrayCalc
4. Sign in with your PrayCalc account to link it

Voice commands

• “Hey Google, ask PrayCalc for the next prayer time”
• “Hey Google, ask PrayCalc when is Fajr”
• “Hey Google, ask PrayCalc for all prayer times today”
• “Hey Google, ask PrayCalc for the Qibla direction”

On Nest Hub and other smart displays, PrayCalc shows a visual card with all five prayer times alongside the voice response.

Routines

You can add PrayCalc queries to Google Home Routines. For example, add “Ask PrayCalc for the next prayer” to your morning routine so it announces Fajr time when you say “Good morning.”

Amazon Alexa

Setup

1. Open the Alexa app on your phone
2. Go to Skills & Games
3. Search for PrayCalc
4. Tap Enable and sign in with your PrayCalc account

Voice commands

• “Alexa, ask PrayCalc for the next prayer”
• “Alexa, ask PrayCalc when is Maghrib”
• “Alexa, ask PrayCalc for today’s prayers”
• “Alexa, ask PrayCalc for the Qibla direction”

On Echo Show devices, a Standard card displays all five prayer times.

Routines

Add PrayCalc to Alexa Routines for automated announcements. Example: trigger “Ask PrayCalc for the next prayer” at sunset daily.

Apple Siri

Siri Shortcuts

PrayCalc provides pre-built Shortcuts that call the PrayCalc REST API and speak the result:

1. Next Prayer - fetches the next prayer time using your current location
2. All Prayers - lists all five prayer times for today
3. Qibla Direction - tells you the Qibla bearing in degrees

Setup

1. Open the Shortcuts app on iOS and create a shortcut using the “Get Contents of URL” action against the REST API (e.g. /api/prayers)
2. Say “Hey Siri, next prayer” to trigger

HomePod

Siri Shortcuts work on HomePod. After adding the shortcuts to your iPhone, say “Hey Siri, next prayer” to any HomePod on the same Apple ID.

Home Assistant

PrayCalc provides a HACS-compatible custom integration for Home Assistant.

Installation via HACS

1. Open HACS in your Home Assistant instance
2. Go to Integrations and click + Explore & Download Repositories
3. Search for PrayCalc
4. Click Download
5. Restart Home Assistant
6. Go to Settings > Devices & Services > Add Integration > PrayCalc
7. Enter your latitude, longitude, calculation method, and madhab

Sensors

The integration creates these sensors:

Configuration

Automation Blueprints

PrayCalc ships 10 ready-to-use Home Assistant automation blueprints:

1. Dim lights at prayer time - dims selected lights when any prayer starts
2. Turn on lights at Fajr - gradually brightens lights at Fajr with configurable transition
3. Play adhan on speaker - plays adhan audio on a media player at prayer time
4. Silence media at prayer - pauses all media players during prayer, resumes after
5. Prayer time TTS - text-to-speech announcement N minutes before prayer
6. Qibla light indicator - flashes a light to indicate Qibla direction
7. Ramadan Iftar countdown - notification N minutes before Maghrib during Ramadan
8. Fajr alarm integration - triggers wake-up scene at Fajr
9. Isha bedtime routine - starts bedtime scene after Isha
10. Jumu’ah reminder - Friday Dhuhr notification

Import blueprints from the smart/blueprints/ directory or through HACS.

REST API

The PrayCalc Smart service exposes a REST API for custom integrations.

Prayer times

GET https://api.praycalc.com/api/v1/times?lat=40.7128&lng=-74.006&date=2026-03-04&method=isna&madhab=shafii

Parameters:

Response:

{
  "prayers": {
    "fajr": "05:42",
    "sunrise": "07:01",
    "dhuhr": "12:15",
    "asr": "15:33",
    "maghrib": "18:02",
    "isha": "19:21"
  },
  "nextPrayer": {
    "name": "Asr",
    "time": "15:33",
    "minutesUntil": 47
  },
  "hijriDate": "15 Ramadan 1447 AH",
  "qibla": { "bearing": 58.42 },
  "meta": {
    "lat": 40.7128,
    "lng": -74.006,
    "date": "2026-03-04",
    "method": "isna",
    "madhab": "shafii",
    "timezone": "UTC"
  }
}

Responses are cached for 1 hour. The Cache-Control header is set to public, max-age=3600.

Webhooks

Register a webhook URL to receive HTTP POST notifications at prayer times.

Register

POST https://api.praycalc.com/api/v1/webhooks
Authorization: Bearer <token>
Content-Type: application/json

{
  "callbackUrl": "https://your-server.com/prayer-hook",
  "lat": 40.7128,
  "lng": -74.006,
  "events": ["fajr", "dhuhr", "asr", "maghrib", "isha"]
}

Webhook payload

When a prayer time arrives, PrayCalc sends:

{
  "event": "prayer_time",
  "prayer": "maghrib",
  "time": "18:02",
  "date": "2026-03-04",
  "lat": 40.7128,
  "lng": -74.006,
  "timestamp": "2026-03-04T18:02:00Z"
}

Maximum 5 webhook registrations per user. Requires authentication.

Subscription

Smart home features are part of Ummat+.

Ummat+ is $9.99/year. Subscribe at praycalc.com/upgrade or through the mobile app.