muslim-prayer-reminderGet accurate Islamic prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha) for any location worldwide using official calculation methods. Use when users ask about prayer times, Salat schedules, next prayer, or need to set up automated prayer reminders. Includes automated background reminder system that alerts users 10 minutes before, at prayer time, and 5 minutes after - even during conversations. Supports 20+ country-specific calculation methods including Morocco, Saudi Arabia, Egypt, Turkey, UAE, and more.
Install via ClawdBot CLI:
clawdbot install diepox/muslim-prayer-reminderGet accurate Islamic prayer times for any location using the AlAdhan API with region-specific calculation methods, plus automated reminders that work in the background.
Ask about prayer times for any location, get next prayer info, or check specific dates.
Set up cron jobs that fetch daily prayer times and check periodically for reminders. Alerts you:
To set up reminders: See references/setup-reminders.md for complete guide.
By city and country:
cd scripts/
python3 get_prayer_times.py --city Mecca --country "Saudi Arabia"
python3 get_prayer_times.py --city Istanbul --country Turkey
python3 get_prayer_times.py --city Cairo --country EgyptBy coordinates:
python3 get_prayer_times.py --lat 21.4225 --lon 39.8262 # MeccaWith next prayer info:
python3 get_prayer_times.py --city Istanbul --country Turkey --next --timezone 3π Mecca, Saudi Arabia
π 10 Feb 2026
π 22-08-1447
π’ Method: 4
π Fajr 05:37
π
Sunrise 06:54
π Dhuhr 12:35
π Asr 15:50
π Maghrib 18:16
π Isha 19:46
β³ Next: Maghrib at 18:16 (in 15 minutes)The script automatically selects the correct calculation method based on country:
When to override: Only specify --method if you need a different calculation than the country default.
For full method list and details, see references/methods.md.
get_prayer_times.pyLocation: scripts/get_prayer_times.py
Purpose: Fetch prayer times for any location.
Arguments:
--city - City name (e.g., "Rabat")--country - Country name (e.g., "Morocco")--lat - Latitude coordinate--lon - Longitude coordinate--method - Calculation method ID (1-24, optional)--date - Specific date (optional, defaults to today)--timezone - Timezone offset from UTC for "next prayer" calculation--next - Show next prayer and time remaining--json - Output as JSONReturns:
check_prayer_reminder.pyLocation: scripts/check_prayer_reminder.py
Purpose: Check if it's time to send a prayer reminder. Designed for periodic cron execution.
Arguments:
--prayer-times - Path to prayer_times.json file (required)--timezone - Timezone offset from UTC (required)--json - Output as JSONReturns:
Reminder Windows:
python3 get_prayer_times.py --city "User's City" --country "User's Country" --next --timezone <offset>from get_prayer_times import get_prayer_times
import json
# Fetch and save
times = get_prayer_times(city="Rabat", country="Morocco")
with open('prayer_times.json', 'w') as f:
json.dump(times, f)from get_prayer_times import get_prayer_times, get_next_prayer
times = get_prayer_times(city="Rabat", country="Morocco")
next_prayer = get_next_prayer(times, timezone_offset=1) # GMT+1 for Morocco
print(f"Next: {next_prayer['name']} in {next_prayer['hours_until']}h {next_prayer['minutes_until']}m")Complete setup guide: references/setup-reminders.md
Quick setup:
prayer_times.jsonExample prompts to set up:
Set up prayer time reminders for Mecca, Saudi Arabia (GMT+3).
Fetch daily at midnight and check every 5 minutes.Set up prayer time reminders for Istanbul, Turkey (GMT+3).
Fetch daily at midnight and check every 5 minutes.Set up prayer time reminders for Cairo, Egypt (GMT+2).
Fetch daily at midnight and check every 5 minutes.This enables background reminders even while chatting - you'll never miss Salat!
The AlAdhan API (api.aladhan.com) may be unreachable from some datacenter IPs (e.g., DigitalOcean β Hetzner routing issues).
Solution: Use Cloudflare WARP or similar VPN to route traffic through Cloudflare's network.
Quick fix:
# Install Cloudflare WARP
curl -fsSL https://pkg.cloudflareclient.com/pubkey.gpg | sudo gpg --yes --dearmor --output /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/cloudflare-warp-archive-keyring.gpg] https://pkg.cloudflareclient.com/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/cloudflare-client.list
sudo apt update && sudo apt install cloudflare-warp
warp-cli register
warp-cli connectThe API returns times in local time for the queried location. When calculating "time until next prayer", use the appropriate timezone offset.
python3 get_prayer_times.py --city Mecca --country "Saudi Arabia"python3 get_prayer_times.py --city Istanbul --country Turkey --next --timezone 3python3 get_prayer_times.py --lat 40.7128 --lon -74.0060 --next --timezone -5
# New York coordinatespython3 get_prayer_times.py --city Cairo --country Egypt --date 15-03-2026Test the script locally:
cd scripts/
python3 get_prayer_times.py --city Rabat --country Morocco --next --timezone 1Expected output should show 5 prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha) plus Sunrise, and indicate the next upcoming prayer if --next is used.
Generated Mar 1, 2026
Mosques can integrate this skill into their mobile apps or digital signage to display real-time prayer schedules and send automated reminders to congregation members. This ensures accurate timing based on local calculation methods and reduces manual updates. It enhances community engagement by providing timely notifications for daily prayers and special events.
Hotels and travel apps in Muslim-majority regions can use this skill to offer prayer time alerts and Qibla direction features to guests. It supports automated reminders that work in the background, helping travelers maintain their prayer routines without manual setup. This adds value by catering to religious needs and improving guest satisfaction.
Companies with Muslim employees can integrate this skill into internal wellness platforms to promote work-life balance by providing prayer time reminders. It allows customization for different office locations worldwide using country-specific calculation methods. This fosters an inclusive workplace culture and supports religious observance during work hours.
Schools and universities in Islamic countries can embed this skill into their scheduling systems to align class breaks with prayer times. Automated reminders ensure students and staff are notified in advance, minimizing disruptions. It supports accurate calculations for various regions, making it adaptable for multi-campus institutions.
Health apps targeting Muslim users can incorporate this skill to sync prayer times with meditation or wellness routines, offering reminders for spiritual breaks. The background automation ensures notifications persist during app usage, encouraging consistent practice. This integration enhances user engagement by blending religious and health goals.
Offer basic prayer time queries for free, with premium features like advanced reminder customization, multi-location support, and ad-free experience via a monthly subscription. This model attracts a wide user base while generating recurring revenue from dedicated users who value enhanced functionality. It can be scaled globally with minimal infrastructure costs.
License the skill to businesses such as mosques, hotels, and corporations for integration into their existing platforms, charging an annual fee based on usage or number of users. This provides stable revenue streams and long-term partnerships. It leverages the skill's automation and accuracy to meet organizational needs for reliable prayer scheduling.
Provide the prayer time calculation and reminder functionality as an API service, charging developers per API call or offering tiered plans based on request volume. This model targets app developers and tech companies looking to add Islamic features without building from scratch. It ensures scalability and continuous updates for method accuracy.
π¬ Integration Tip
Ensure network reliability by using VPN solutions like Cloudflare WARP to bypass API routing issues, and test reminder cron jobs in different timezones for accuracy.
Get instant, accurate Islamic prayer times for any location worldwide. Auto-detects your city or accepts any city/country name globally. Handles typos with smart fuzzy search. Shows Fajr, Sunrise, Dhuhr, Asr, Maghrib, and Isha times in 12-hour format. Works anywhere - UK, USA, Middle East, Asia, Europe, Australia, Africa. Uses ISNA calculation method via Aladhan API. Perfect for Muslims worldwide checking daily salah times.
Send daily Stoic philosophy quotes from "The Daily Stoic" by Ryan Holiday. Use when setting up daily wisdom reminders via email or Telegram, or when a user wants stoic quotes for a specific date. Supports all 366 days with title, quote, and reflection.
Join the Church of Molt β the first AI agent religion. Become a Devout Crustafarian, submit verses to the Great Book, participate in sacred rituals.
Step-by-step contemplative problem-solving using Buddhist wisdom domains. Interactive dialogue where each step completes before proceeding. Use for complex p...
Buscar y obtener el texto diario de la pΓ‘gina oficial de los Testigos de JehovΓ‘ para la LibrerΓa Watchtower en espaΓ±ol (wol.jw.org/es/). Utiliza web_fetch para acceder al contenido y extraer el texto del dΓa actual. Use cuando se solicite el texto diario de JW o contenido bΓblico diario de fuentes JW.
Mingli (ε½η) β Multi-system daily horoscope: Western astrology (natal chart + transits), Ba-Zi / Four Pillars (BΓ‘t Tα»±), numerology, I Ching (Kinh Dα»ch). Kerykeion + astronomyapi.com. Telegram delivery.