Azan
Azan + Prayer Time + MCP + AI Agents + Islamic + Salah + A lightweight MCP library to calculate prayer times and trigger Azan with a single tool call. If you’re building an AI agent or prayer application, there’s no need to deal with astronomical cal
What is Azan?
Azan is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to azan + prayer time + mcp + ai agents + islamic + salah + a lightweight mcp library to calculate prayer times and trigger azan with a single tool call. if you’re building an ai agent or prayer applicat...
Azan + Prayer Time + MCP + AI Agents + Islamic + Salah + A lightweight MCP library to calculate prayer times and trigger Azan with a single tool call. If you’re building an AI agent or prayer application, there’s no need to deal with astronomical cal
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Azan + Prayer Time + MCP + AI Agents + Islamic + Salah + A l
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx azanConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Azan
The Azan MCP server is a lightweight Islamic prayer-time toolkit that exposes 34 tools covering prayer schedules, Azan text, Hijri calendar conversion, du'a and dhikr collections, Zakat calculation, and the 99 Names of Allah — all accessible from any MCP-compatible AI agent. It handles the full astronomical calculation pipeline internally, so you can integrate accurate prayer times into an application or AI workflow without writing a single line of calendar math. Configured with a latitude, longitude, timezone, and calculation method, it works for any location worldwide and supports multiple madhabs and Iqama offsets. This makes it ideal for building Islamic apps, prayer-time bots, or AI agents that need religiously accurate scheduling.
Prerequisites
- Python 3.12 or later
- uv package manager installed (curl -LsSf https://astral.sh/uv/install.sh | sh)
- Your geographic coordinates (latitude, longitude) and timezone string (e.g. 'Asia/Riyadh')
- An MCP-compatible client such as Claude Desktop or Claude Code
Install uv
The server is published to PyPI and runs via uvx, which is part of the uv toolchain.
curl -LsSf https://astral.sh/uv/install.sh | shCreate an azan-config.json file
Create a configuration file with your location, timezone, calculation method, and optional Iqama offsets. The calculation_method should match your region (e.g. umm_al_qura for Saudi Arabia, isna for North America).
{
"latitude": 21.3891,
"longitude": 39.8579,
"timezone": "Asia/Riyadh",
"calculation_method": "umm_al_qura",
"madhab": "shafi",
"iqama_offsets": {
"fajr": 20,
"dhuhr": 10,
"asr": 10,
"maghrib": 5,
"isha": 15
}
}Test the server directly
Run the server once from the command line to verify it starts without errors before adding it to a client.
AZAN_CONFIG=/path/to/azan-config.json uvx azan-mcpAdd to Claude Desktop
Add the server entry to your Claude Desktop configuration file, pointing AZAN_CONFIG at your JSON file.
Azan Examples
Client configuration
Claude Desktop configuration block for the Azan MCP server with environment variable pointing to your location config file.
{
"mcpServers": {
"azan": {
"command": "uvx",
"args": ["azan-mcp"],
"env": {
"AZAN_CONFIG": "/path/to/azan-config.json"
}
}
}
}Prompts to try
Example questions and tasks you can ask your AI assistant once the Azan server is connected.
- "What are today's five prayer times for my location?"
- "When is the next prayer, and how many minutes away is it?"
- "Convert today's Gregorian date to the Hijri calendar."
- "What is the Qibla direction from my coordinates?"
- "Calculate my Zakat obligation on 500 grams of silver."
- "Show me the morning adhkar with their hadith sources."Troubleshooting Azan
Server starts but prayer times are incorrect
Double-check your latitude, longitude, and timezone values in azan-config.json. Also verify that the calculation_method matches your regional authority (e.g. isna for North America, mwl for Muslim World League, egypt for Egyptian General Authority).
AZAN_CONFIG environment variable is not recognized
Ensure the env block in your MCP client config JSON contains the full absolute path to the file (not a relative path), and that the file exists and is valid JSON before starting the client.
uvx command not found after installing uv
Restart your shell or run 'source ~/.bashrc' (or ~/.zshrc) so the uv bin directory is on your PATH. Verify with 'which uvx'.
Frequently Asked Questions about Azan
What is Azan?
Azan is a Model Context Protocol (MCP) server that azan + prayer time + mcp + ai agents + islamic + salah + a lightweight mcp library to calculate prayer times and trigger azan with a single tool call. if you’re building an ai agent or prayer application, there’s no need to deal with astronomical cal It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Azan?
Follow the installation instructions on the Azan GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Azan?
Azan works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Azan free to use?
Yes, Azan is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Azan Alternatives — Similar Business Applications Servers
Looking for alternatives to Azan? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台,「低代码 + 零代码」双模式驱动:低代码一键生成前后端代码,零代码 5 分钟搭建系统,AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等,兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式,消除 Java 项目 80% 的重复工作,提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理,能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长,比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入,可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI,能处理文本、语音、图片和文件,可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Azan in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Azan?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.