# Prayer Times [Health: Active]

**Category:** 🔮 Spirituality & Esoterica  
**Repository:** https://github.com/pipeworx-io/mcp-prayer-times  
**GitHub Stars:** 0  
**npm Downloads (last month):** 427  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/prayer-times

## Description
Islamic prayer times & calendar MCP (Aladhan API). Keyless.

## Tools
Capabilities this server exposes over MCP:

- **prayer_times** — Islamic prayer times (salah times: Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha, plus Imsak and Midnight) for a location today. Provide either city+country or latitude+longitude. Returns timings, Gregorian and Hijri (Islamic calendar) dates, timezone, and the calculation method used.
- **qibla** — Qibla direction (compass bearing toward the Kaaba in Mecca) for a given latitude/longitude, in degrees from true north.
- **convert_to_hijri** — Convert a Gregorian date to the Hijri (Islamic) calendar date. Useful for Islamic calendar date conversion.
- **hijri_calendar** — Monthly Islamic prayer-times calendar for a city: per-day Gregorian and Hijri (Islamic calendar) dates with salah times (Fajr, Dhuhr, Maghrib, Isha).

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "prayer-times": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-prayer-times"]
  }
}
```

## Documentation

## What Prayer Times does

Prayer Times exposes Islamic prayer and calendar functions through the Model Context Protocol. Its data is provided through the Aladhan API and made available through the Pipeworx gateway. The integration is independent and unofficial, and it does not require an API key for basic anonymous use.

The server covers four focused operations:

- Retrieve today’s prayer schedule for a city and country or for latitude and longitude.
- Calculate the Qibla bearing from a latitude and longitude.
- Convert a Gregorian date into its Hijri equivalent.
- Retrieve a city’s monthly Islamic prayer calendar.

Daily prayer results include Fajr, Sunrise, Dhuhr, Asr, Maghrib, Isha, Imsak, and Midnight, along with Gregorian and Hijri dates, timezone information, and the calculation method. Monthly calendar entries include Gregorian and Hijri dates plus Fajr, Dhuhr, Maghrib, and Isha times.

## How it works

A hosted MCP connection can use the scoped endpoint at `https://gateway.pipeworx.io/prayer-times/mcp`. The same service can also be reached through the full Pipeworx gateway at `https://gateway.pipeworx.io/mcp`. Pack endpoints list the Prayer Times tools directly and also expose shared Pipeworx meta-tools, including `ask_pipeworx`, `discover_tools`, `search_within`, and memory-related tools. The `ask_pipeworx` tool can route a natural-language request to the appropriate catalog tool.

For clients without MCP support, the gateway provides HTTP access. For example, `POST https://gateway.pipeworx.io/v1/tools/prayer_times` accepts a JSON request such as `{ "city": "London", "country": "UK" }`. Tool schemas can be inspected with the corresponding HTTP endpoint.

## Setup and configuration

For a hosted connection, add the MCP URL to a compatible client:

```json
{
  "mcpServers": {
    "prayer-times": {
      "url": "https://gateway.pipeworx.io/prayer-times/mcp"
    }
  }
}
```

The npm package provides a local stdio bridge:

```json
{
  "mcpServers": {
    "prayer-times": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-prayer-times"]
    }
  }
}
```

The bridge forwards requests to the hosted gateway and requires network access. Anonymous use is available with a limit of 50 calls per day. A free Pipeworx account increases the limit to 200 calls per day; its key can be supplied as `PIPEWORX_API_KEY`. Set `PIPEWORX_META_TOOLS=1` if the local bridge should list the gateway-wide meta-tools as well as the Prayer Times tools. When using an HTTPS proxy, `NODE_USE_ENV_PROXY=1` may be needed for newer Node releases to honor `HTTPS_PROXY`.

## Tools and capabilities

`prayer_times` accepts either city and country or geographic coordinates and returns the day’s timings, calendar dates, timezone, and calculation method.

`qibla` calculates the direction toward the Kaaba in Mecca as degrees from true north using latitude and longitude.

`convert_to_hijri` handles Gregorian-to-Hijri date conversion.

`hijri_calendar` returns a city’s monthly calendar with daily Gregorian and Hijri dates and selected salah times.

## Limitations and notes

The npm bridge is online-only and has no offline mode. Anonymous calls are capped at 50 per day, while a free account raises the allowance to 200 calls per day. Hosted and local connections use the Pipeworx gateway. The integration is independent and unofficial rather than affiliated with, endorsed by, or published by the upstream provider.

_Full upstream README: https://allmcps.com/mcp/prayer-times/readme_