Skip to content

Connect ChatGPT to the Shamela library

Add the Quran Gallery MCP server to ChatGPT step by step, with screenshots: one URL, No authentication, then search 8,594 classical Arabic books.

On this page

No account, no sign-in, no key. Add this URL to ChatGPT as a custom MCP server and set Authentication to No authentication:

https://qurangallery.com/mcp/shamela

Setup takes about a minute. It worked on a Free ChatGPT account when this guide was written (October 2026). On a Business or Enterprise workspace, an admin may have to allow custom MCP servers first.

1. Open Plugins and add a custom server

Open chatgpt.com/plugins. At the top right, click Add, then Add custom MCP server.

The Add menu at the top right of the ChatGPT Plugins page: Create plugin, Upload plugin archive, Add custom MCP server.

2. Fill in the form

FieldEnter
Icon (optional)quran-gallery-icon.png: download it, then click + and pick the file
NameQuran Gallery
Description (optional)Search classical Arabic Islamic books with printed-page citations
ConnectionKeep Server URL selected and paste https://qurangallery.com/mcp/shamela
AuthenticationNo authentication

Tick I understand and want to continue, then click Create as a plugin.

The Add custom MCP server dialog, filled in: the Quran Gallery icon, name and description, Server URL https://qurangallery.com/mcp/shamela, Authentication set to No authentication, and the I understand box ticked.

Type the URL yourself or copy it from this page. A link copied from an email can be a google.com/url?q=… redirect rather than the address itself, and ChatGPT rejects it.

3. Connect

ChatGPT shows what the plugin may do. Click Connect. A message confirms Quran Gallery is now connected.

The Connect Quran Gallery screen with its Connect button.

4. Check that it is installed

Open Settings → Plugins. Quran Gallery appears in the list with its icon. All of its tools are read-only.

ChatGPT plugin settings, with Quran Gallery in the list of installed plugins.

5. Use it in a chat

Start a new chat. Click + in the message box and pick Quran Gallery. Then ask your question.

The + menu of a new ChatGPT chat, with Quran Gallery in the list.

The answer names the edition, volume and printed page, and links to that page in the Maktabah reader:

A ChatGPT answer using Quran Gallery: Sahih al-Bukhari, Sultaniyya edition, volume 1 page 6, hadith 1, with a link to the page on Shamela.

Manage, refresh or remove

Open Settings → Plugins and click Quran Gallery. Under Manage app you can rename it, Refresh tools after our server adds a tool, or Delete app.

The Manage app section of the plugin: App name, App description, Refresh tools and Delete app.

You cannot edit the server URL or the icon once the plugin exists. To change either, delete the plugin and add it again.

Deep research

ChatGPT deep research and company knowledge need two read-only tools named search and fetch. This server provides both, listed to every client alongside the other tools. search takes one query and returns results with id, title and url; fetch takes an id and returns id, title, text, url and metadata. The url of every result is the page in the Maktabah reader.

First prompt to try

Find the hadith «إنما الأعمال بالنيات» in the primary collections and tell me which book, edition, volume and page it is printed on. Quote the Arabic exactly.

Your assistant should call shamela_search_library (or search then fetch). The hits include صحيح البخاري, ط السلطانية, page 1/6, with a link to that page in the Maktabah reader. If it answers from memory instead, say: “Use the Quran Gallery library tool and quote what it returns.”

Search queries must be in Arabic; your assistant translates English terms first (details). Ready-made prompts for takhrīj, citing a passage and comparing tafsir are listed in the full tool surface.

Troubleshooting

  • “Some app settings were rejected. Check the server URL or tunnel ID, icon, and authentication settings.” Check three things. The URL must be exactly https://qurangallery.com/mcp/shamela, not a redirect link from an email. Authentication must be No authentication. The icon must be a PNG of at least 256×256 pixels and under 10 KB; ours fits, or you can leave the icon out. If you tried before our fix, add the server again.
  • “Couldn’t discover OAuth settings.” Authentication was left on OAuth. Change it to No authentication.
  • “An app with this name already exists.” You added it before. Delete the old plugin first (see Manage, refresh or remove), or pick another name.
  • Create as a plugin does not respond. Tick I understand and want to continue first.
  • No Plugins page or no Add custom MCP server. Older accounts reach the same form through Settings → Apps & Connectors → Advanced settings → Developer mode → Create. Use the same URL and No authentication. On a work account, ask your workspace admin to allow custom MCP servers.
  • 429, “Keyless limit reached”. Keyless use allows 10 tool calls a minute and 200 a day per IP address. Wait for the Retry-After header. See Limits and errors.
  • 503. The server or the library behind it is briefly unavailable. Retry after the Retry-After header. If the plugin lists zero tools, wait a minute and click Refresh tools.
  • The tools do not appear, or a tool you expect is missing. ChatGPT reads the tool list when you create the plugin. Click Refresh tools, then start a new conversation.
  • Connection fails immediately. The endpoint is /mcp/shamela. The bare /mcp is a web page, not the server.

Optional: a free key for higher limits

A key is never required. A free key raises the limit to 60 calls a minute and lifts the keyless page-range caps. ChatGPT’s custom-server form offers only OAuth or no authentication, with no field for a bearer header, so ChatGPT stays on the keyless tier. If you need the key, use Claude, Claude Code, Cursor, VS Code or Gemini CLI. Create one on the Developers page of your Quran Gallery account (how keys work).

Next steps

Edit this page on GitHub