Azan-MCP
An MCP server with 34 tools: prayer times for any point on Earth, the Hijri calendar, adhkar, zakat and inheritance calculation
- 383 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- Calculations run on formulas and data from the package; no keys or outside services are required
Install
- Works in
Manual install
uvx azan-mcpThe quick start from the README. The settings file is passed in the AZAN_CONFIG variable.
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Calculations run on formulas and data from the package; no keys or outside services are required
This is third-party code. Review the repository files before installing.
What it does
Azan-MCP is a Python and FastMCP server that gives an agent reference and calculation tools for Islamic practice. It starts with `uvx azan-mcp`, runs locally and keeps its data inside the package. Prayer times are computed with the Meeus astronomical algorithm for any point on Earth: the five daily prayers plus sunrise, 10 calculation methods and two madhabs for the Asr time. It also gives the qibla bearing, a monthly calendar, the windows of the optional Duha, Awwabin and Tahajjud prayers, and the azan text in Arabic and transliteration with the Fajr variant. Iqama times derive from the azan by configured offsets. Other modules convert dates between the Gregorian and Hijri calendars, name the dates of Ramadan, Eid and voluntary fasting, and return morning and evening adhkar and du'as on 15 topics with a hadith reference and a confidence level. Calculators compute zakat, the nisab threshold for gold and silver, suhoor and iftar times and inheritance shares under faraid with aul handling. The 99 Names of Allah are available with search. Every response carries a meta block with the calculation method, the madhab and the source.
Who it is for. For Muslims who want accurate prayer times and calculations inside an assistant, and for developers of apps and agents who would rather not write astronomy and timezone handling themselves.
Good fit when
- You want the five prayer times for today or for a month for your city and a chosen calculation method
- The agent should say how many minutes remain until the next prayer
- You need to convert a Gregorian date to Hijri and find the dates of Ramadan and Eid
- You want to calculate zakat on cash, gold or trade goods and check the nisab threshold
- A mosque app needs iqama times with offsets and the full azan schedule for the day
Not a fit when
- You need a religious ruling on a disputed question: the zakat, faraid and calendar tools themselves advise consulting a qualified scholar
- You need to play the sound of the azan: the server returns text, not audio
- You need full texts of the Quran or hadith collections: the server returns only the adhkar, du'as and names built into it
- You need a lasting iqama offset after a restart: set_iqama_offset lasts only until the server restarts, permanent values go in the config file
Example request
Show tomorrow's prayer times in Kazan by the Muslim World League method and how long until Maghrib.MCP
- Transport
- stdio
- Authentication
- not required
Environment variables
AZAN_CONFIG- Path to the azan-config.json file with coordinates, timezone, calculation method, madhab and iqama offsets.
Limitations
Python 3.12 or newer is required. Location, timezone, calculation method, madhab and iqama offsets are set in a file whose path goes into the AZAN_CONFIG variable. An example sits in examples/azan-config.example.json. Configure it for your city first.
The author reports accuracy within two minutes against IslamicFinder, but the repository holds no independent comparison, and the choice of method and madhab shifts the result, so check the output against your local mosque or calendar. Each du'a and dhikr carries a hadith and a confidence level, while the project is still at version 0.1.0.
For zakat and inheritance the tools compute by formula, and you supply the gold and silver prices yourself. Availability from Russia was not checked when this card was prepared.
How to disable. Remove the azan block from the MCP client config and restart the client. Delete the settings file too if you no longer need it.
FAQ
How do I install Azan-MCP in Claude Desktop?
Add an azan server to `claude_desktop_config.json` with the `uvx` command and the argument `azan-mcp`. Set AZAN_CONFIG in env to the path of your settings file. Nothing else is needed: no npm and no Docker.
Which prayer time calculation methods does Azan-MCP support?
Ten: Umm al-Qura in Makkah, Muslim World League, ISNA, Egyptian, Karachi, Tehran, Kuwait, UOIF in France, Ithna Ashari and Muhammadiyah. For Asr you choose the Hanafi or Shafi madhab. The list_calculation_methods tool returns the full list with Fajr and Isha angles.
Can I trust the zakat and inheritance calculations?
The tools compute by formula: 2.5% above the nisab threshold, nisab as 85 grams of gold and 595 grams of silver, shares under Quran 4:11-12 in exact fractions. Every response reminds you to consult a qualified scholar.
Where do the du'as and adhkar get their sources?
Each entry stores a hadith reference and a confidence level: high for Bukhari and Muslim, medium for the Sunan collections. This is data built into the package; the server does not search the web.
Does the server store my location anywhere?
No. Coordinates live in your config file on your machine, calculation runs on the algorithm in the package, and an iqama offset changed through set_iqama_offset lives only in memory until a restart.
Discussion
No questions or reviews yet.
Related
MCP serversOpenFate Bazi MCP: Bazi chart calculation
OpenFate Bazi MCP
An MCP server that calculates Bazi charts and true solar time deterministically so the model skips calendar guesswork
Passage of Time MCP gives a model the current time and seven tools for intervals, shifts and date context, so it stops doing time arithmetic in its head
An MCP server that calculates a Bazi chart from a birth date and returns the Chinese almanac, with no guessing of characters
Official Astravue plugin and MCP server: 87 tools for tasks, projects, time tracking and 8 ready planning skills.
An MCP server and CLI that compute natal charts, Bazi, Qimen and tarot offline, so the agent works from real chart data
MCP server for the macOS calendar: an agent creates, finds and edits events in natural language
README in short
The README splits the 34 tools across six modules and tabulates each with a description. It separately states the project principles: calculation accuracy, cited sources, a meta block in responses and the reminder about a scholar. It shows the quick start, Claude Desktop setup, an example config file and how to run the tests.