| name | deen-time |
| description | Get daily Islamic prayer (Salah) times, Iftar, and Suhoor schedules for any location worldwide. Supports 15+ calculation methods, Hijri dates, and Ramadan calendars. |
| metadata | {"openclaw":{"requires":{"bins":"[Truncated]","env":"[Truncated]"},"homepage":"https://aladhan.com/prayer-times-api"}} |
| user-invokable | true |
| disable-model-invocation | false |
Deen Time
Your daily Islamic prayer companion. Provides accurate Salah times (Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha) for any city or coordinates worldwide. During Ramadan, also provides Suhoor (pre-dawn meal) and Iftar (fast-breaking) schedules with full monthly calendars.
When to Use This Skill
Use this skill when the user asks about:
- Prayer times for a specific location
- Iftar or Suhoor times
- Ramadan schedule or timetable
- When to break fast or start fasting
- Fajr, Dhuhr, Asr, Maghrib, or Isha times
- Islamic prayer schedule
How It Works
This skill uses the Aladhan Prayer Times API (https://aladhan.com/prayer-times-api), a free and reliable public API that requires no authentication.
Fetching Prayer Times by City
curl -L "https://api.aladhan.com/v1/timingsByCity?city={CITY}&country={COUNTRY}&method={METHOD}"
Replace {CITY}, {COUNTRY}, and {METHOD} with actual values. URL-encode spaces (e.g., New%20York). Always use -L to follow redirects.
Fetching Prayer Times by Coordinates
curl -L "https://api.aladhan.com/v1/timings/{DD-MM-YYYY}?latitude={LAT}&longitude={LNG}&method={METHOD}"
Use this when the user provides latitude/longitude or when a city name is ambiguous.
Fetching a Full Monthly Calendar
curl -L "https://api.aladhan.com/v1/calendarByCity/{YEAR}/{MONTH}?city={CITY}&country={COUNTRY}&method={METHOD}"
Use this for Ramadan schedules. {MONTH} is the Gregorian month number (1-12).
Calculation Methods
The method parameter controls prayer time calculation. Pick the most appropriate one based on the user's region:
| Method | Organization | Best For |
|---|
| 1 | University of Islamic Sciences, Karachi | Pakistan, Bangladesh, India |
| 2 | Islamic Society of North America (ISNA) | North America |
| 3 | Muslim World League (MWL) | Europe, Far East |
| 4 | Umm Al-Qura University, Makkah | Saudi Arabia, Gulf |
| 5 | Egyptian General Authority of Survey | Africa, Syria, Lebanon |
| 7 | Institute of Geophysics, University of Tehran | Iran |
| 8 | Gulf Region | UAE, Kuwait, Qatar |
| 9 | Kuwait | Kuwait |
| 10 | Qatar | Qatar |
| 11 | Majlis Ugama Islam Singapura | Singapore |
| 12 | Union Organization Islamic de France | France |
| 13 | Diyanet Isleri Baskanligi | Turkey |
| 14 | Spiritual Administration of Muslims of Russia | Russia |
| 15 | Moonsighting Committee Worldwide | Global (moonsighting-based) |
Defaults: Use method 2 for North America, 4 for Saudi/Gulf, 3 for Europe, 5 for Africa, 13 for Turkey, 1 for South Asia. If the user doesn't specify a preference, select based on their location.
API Response Structure
The API returns JSON. The key fields to extract:
{
"data": {
"timings": {
"Fajr": "05:12",
"Sunrise": "06:30",
"Dhuhr": "12:15",
"Asr": "15:30",
"Maghrib": "18:00",
"Isha": "19:20",
"Imsak": "05:02"
},
"date": {
"readable": "19 Feb 2026",
"hijri": {
"date": "02-09-1447",
"month": { "number": 9, "en":
For the calendar endpoint, data is an array of day objects with the same structure.
Presenting Results
Daily Prayer Times
Display as a clean table:
Prayer Times for {City}, {Country}
Date: {Gregorian Date} | {Hijri Date}
| Prayer | Time |
|----------|--------|
| Fajr | 05:12 |
| Sunrise | 06:30 |
| Dhuhr | 12:15 |
| Asr | 15:30 |
| Maghrib | 18:00 |
| Isha | 19:20 |
Suhoor: Stop eating before 05:12 (Fajr). Recommended: 05:02 (Imsak).
Iftar: Break fast at 18:00 (Maghrib).
Ramadan Monthly Schedule
For monthly requests, present a condensed table:
Ramadan Schedule for {City} — {Year}
| Day | Date | Suhoor (Imsak) | Fajr | Iftar (Maghrib) |
|-----|------------|-----------------|-------|-----------------|
| 1 | 17 Feb | 05:02 | 05:12 | 17:45 |
| 2 | 18 Feb | 05:01 | 05:11 | 17:46 |
| ... | ... | ... | ... | ... |
Important Notes to Convey
- Suhoor must be completed before Fajr. The Imsak time (typically 10 min before Fajr) is the recommended cutoff.
- Iftar is at Maghrib (sunset).
- All times are in the local timezone of the requested location.
- If the user doesn't specify a location, ask for their city and country.
- If the user doesn't specify a date, use today's date.
Example Interactions
User: "What are the prayer times for London today?"
→ Call: curl -L "https://api.aladhan.com/v1/timingsByCity?city=London&country=United%20Kingdom&method=3"
→ Display all prayer times in a formatted table with both Gregorian and Hijri dates.
User: "When is Iftar in Dubai?"
→ Call: curl -L "https://api.aladhan.com/v1/timingsByCity?city=Dubai&country=United%20Arab%20Emirates&method=4"
→ Highlight the Maghrib time as the Iftar time.
User: "Give me the Ramadan schedule for Istanbul"
→ Determine the Gregorian months that overlap with Ramadan for the current year.
→ Call: curl -L "https://api.aladhan.com/v1/calendarByCity/2026/2?city=Istanbul&country=Turkey&method=13" (and March if Ramadan spans two months)
→ Filter to only Ramadan days (check Hijri month = 9 / Ramadan) and present the Suhoor/Iftar table.
User: "Suhoor time for New York?"
→ Call: curl -L "https://api.aladhan.com/v1/timingsByCity?city=New%20York&country=United%20States&method=2"
→ Show the Imsak and Fajr times. Recommend stopping eating at Imsak (10 min before Fajr).
User: "Prayer times for coordinates 21.4225, 39.8262"
→ Call: curl -L "https://api.aladhan.com/v1/timings/19-02-2026?latitude=21.4225&longitude=39.8262&method=4"
→ Display full prayer times (these coordinates are Makkah, so use Umm Al-Qura method).
Privacy and Data Handling
This skill makes read-only HTTPS requests to the Aladhan Prayer Times API, a well-known, free, public Islamic prayer times service.
- Data sent: Only the city/country name or coordinates provided by the user, plus a calculation method number. No personal data, credentials, or device information is transmitted.
- Data received: Prayer times (JSON) for the requested location and date. No tracking, cookies, or user profiling.
- No authentication: The API requires no API keys, tokens, or accounts.
- No data storage: This skill does not write to disk, store user data, or maintain any state between invocations.
- Single domain: All network requests go exclusively to
api.aladhan.com over HTTPS. No other external endpoints are contacted.
