Connect Claude or ChatGPT

You can connect SalahClock to an AI assistant and then just ask for things:

"What time is Fajr at Baitul Mukarram tomorrow?"

"Move Isha iqamah to 20 minutes after the adhan."

"Put up an announcement about Friday's fundraiser."

Nothing is installed on your displays and nothing changes about how they work. The assistant talks to your SalahClock account the same way you do when you open the dashboard — and only as far as you allow.

Connect it — Claude

1. 1

   Open connector settings

   In Claude, go to Settings → Connectors, then Add custom connector. This works on claude.ai, the desktop app, and mobile — connect once and it follows you across all three.

2. 2

   Paste the SalahClock address

   Enter exactly:

   https://salahclock.app/mcp

   Leave the OAuth client ID and secret fields empty — SalahClock registers Claude automatically. Press Add.

3. 3

   Sign in to SalahClock

   Claude opens a SalahClock page. Sign in as you normally would.

4. 4

   Choose what it can reach

   This is the part that matters. Pick which clocks Claude may touch — all of them, or only the ones you tick — and whether it may only read or also make changes. Then press Authorize.

Ask "what are today's prayer times at my masjid?" to check it worked.

Connect it — ChatGPT

1. 1

   Turn on Developer mode

   In ChatGPT, click your profile picture → Settings → Security and login, and switch on Developer mode. ChatGPT shows a warning that custom plugins run third-party code on your behalf — read it and accept.

2. 2

   Add the plugin

   Go to Settings → Plugins and press the + button, which only appears once Developer mode is on. Give it a name (SalahClock) and a short description.

3. 3

   Paste the SalahClock address

   Under Connection, enter exactly:

   https://salahclock.app/mcp

   The /mcp at the end is required. Create the connection.

4. 4

   Sign in and choose what it can reach

   ChatGPT sends you to SalahClock to sign in. Pick which clocks it may touch and whether it may only read or also make changes, then press Authorize.

Other assistants

Anything that speaks the Model Context Protocol can connect to the same address — Claude Code, and a growing number of other tools. The address never changes:

https://salahclock.app/mcp

What it can do

Reading — your list of clocks, every setting on them, prayer times for any day or range, which screens are currently online, and your plan's limits.

Making changes, if you allowed it — the calculation method and madhab, iqamah offsets, fixed prayer times, the announcement banner, theme and screen rotation, languages and prayer names, supplementary clocks, Jumu'ah setup, prayer takeovers, adhan audio, the overnight screen schedule, content slides, and whether the clock is listed publicly.

What it can never do

Some things are deliberately out of reach, no matter what you authorize:

• Delete a clock. Deleting is a one-way door and stays a human decision.
• Touch billing. It cannot upgrade, downgrade, or cancel anything.
• Reach your account settings, export your data, or delete your account.
• Change the display passcode or read it.
• Use admin tools, even if your account happens to be a SalahClock admin.

It also cannot do anything your plan does not allow. Ask it to switch to a paid theme on a free plan and it will tell you that the theme needs an upgrade, exactly as the dashboard does.

Read-only is a real option

If you only want quick answers — "when is Maghrib on Friday?" — choose Look, but don't touch when you connect. Every settings tool then refuses, and the assistant will say so plainly. You can reconnect later and grant changes if you change your mind.

Approve each change

Assistants ask before running anything that alters a setting, so you see what is about to happen and can say no. Reading is not interrupted this way — questions get answered without prompting you each time.

The prayer-times card

When you ask about prayer times, some assistants show a small SalahClock card instead of a plain list: the day's adhan and iqamah times, the next prayer with a live countdown, and buttons to flip between days. Times are always shown in the mosque's own timezone, not yours, so asking from another country still gives you the times the congregation sees.

Verified and unverified apps

The consent screen tells you who is asking:

• Verified — SalahClock recognises the app, such as Claude or ChatGPT.
• Running on your computer — a local tool like Claude Code. We cannot confirm which program is asking, so only continue if you just started it.
• Not verified — anyone can build an app and name it anything, including a name that copies one you trust. For these, the screen names the exact server your access would be sent to and asks you to confirm you recognise it.

If an app claims to be a service it isn't, SalahClock blocks it outright and no consent screen appears.

Disconnect at any time

Go to Dashboard → Account → Connected AI assistants and press Disconnect. Access stops immediately and the app is signed out.

We also email you whenever an app is connected, naming what it can do and where its access goes — so if it wasn't you, you find out straight away and can cut it off.

If it stops working

• "Access was revoked" — the connection was disconnected here. Reconnect from your assistant.
• "Read-only access" — you chose Look, but don't touch. Reconnect and pick Read and make changes.
• "That clock isn't part of what you authorized" — the clock wasn't ticked when you connected. Reconnect and include it.
• "Too many requests" — an assistant got stuck in a loop. Wait a minute and start a fresh request.
• "That authorization has expired" — reconnect from your assistant. Signing out of the SalahClock dashboard does not do this: a connected assistant stays connected until you disconnect it here or the assistant's own access is revoked.

Still stuck? See Common issues.