DeenclawGitHub

Deenclaw 101

Your deen-specialised AI assistant, right inside iMessage.

What is Deenclaw?

Deenclaw is an AI assistant for your relationship with the Quran. It lives in iMessage. Text the address, ask anything, and Deenclaw replies like a friend. Every ayah, translation, and tafsir comes from a real call to the Quran Foundation API or the Quran MCP. Deenclaw never paraphrases or invents Quranic text.

Daily ayah

Pick a delivery time during onboarding and Deenclaw sends a verse, recitation, and a short reflection prompt every day in your timezone. No app to open.

Ask in plain language. Say "what does the Quran say about patience?" and Deenclaw runs a semantic search through the Quran MCP, returns the matching verses, and can pull tafsir from Ibn Kathir or any scholar the Content API supports.

Audio recitation

Pick your reciter (Mishary, Abdul Basit, Husary, others) and Deenclaw attaches the audio to your iMessage thread. Files arrive as native attachments, ready to play.

Prayer times

Share your city during onboarding and Deenclaw nudges you ten minutes before each salah using the Aladhan API, with a pre-prayer du'a from the content library. ISNA is the default calculation method.

Bookmarks and hifz

Say "save this" and Deenclaw bookmarks the verse to your Quran.com account through the User API. Track hifz sessions by surah and verse range, build collections, log goals, and publish reflections to QuranReflect.

Memory

Each user has a private memory file. Preferences, goals, and anything persistent are kept across conversations and injected into the system prompt.

iMessage and SMS

Deenclaw lives in iMessage. Text the address from any iPhone, iPad, or Mac signed into your Apple ID. SMS works automatically through Apple's Text Message Forwarding from a linked iPhone.