Azan

v1.0.0Business Applicationsstable

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

adhanadhan-playerai-agentsandroid-prayer-timesazan
Share:
381
Stars
0
Downloads
0
Weekly
0/5

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

Islamic prayer time calculations
Azan call-to-prayer triggering
Salah scheduling for AI agents
ahmedeltaher

Maintainer

LicenseApache-2.0
Languagekotlin
Versionv1.0.0
UpdatedMay 11, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx azan

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

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
1

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 | sh
2

Create 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
  }
}
3

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-mcp
4

Add 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.1k

A 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.4k

AI 低代码平台,「低代码 + 零代码」双模式驱动:低代码一键生成前后端代码,零代码 5 分钟搭建系统,AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等,兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式,消除 Java 项目 80% 的重复工作,提效而不失灵活。

CowAgent

44.7k

CowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理,能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长,比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入,可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI,能处理文本、语音、图片和文件,可快速搭建个人AI助理和企业数字员工。

Minds Platform

39.2k

Platform 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.8k

AI 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.

Quick Config Preview

{ "mcpServers": { "azan": { "command": "npx", "args": ["-y", "azan"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

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.

33,000+ ServersFree & Open SourceStep-by-Step Guides