Quran.com API

Quran.com API is an MCP server that connects large language models directly to the official Quran.com REST API v4. Built from the Quran.com OpenAPI specification, it allows AI clients like Claude Desktop to retrieve Islamic textual data, translations, tafsir commentaries, and audio metadata in real time. Researchers, software developers, Islamic studies scholars, and students can use this integration to search the Quranic corpus using specific semantic or textual queries without manually visiting external web portals. The server enables users to fetch full chapters, look up verses by chapter number, page, Juz, Hizb, Rub el Hizb, or verse key, and extract randomized verses for study. Beyond primary scriptures, it exposes tools to query multiple translations, look up classical tafsirs by resource ID, find audio recitations by reciter or style, and inspect available linguistic resources across supported languages. By wrapping the v4 REST endpoints into Model Context Protocol tools, it facilitates contextual religious inquiry, accurate citation retrieval, and detailed textual study directly inside conversational LLM workflows.

Category: Notes & Knowledge Management

Tags: islamic-studies, quran, religious-texts, theology

Visit Quran.com API

How to install and configure Quran.com API

1. Clone the repository and ensure you have Node.js 22+ or Docker installed. 2. If building with Docker, run docker build -t quran-mcp-server . in the root directory. If running via Node.js, install dependencies and run npm run build. 3. Open your Claude Desktop configuration file (claude_desktop_config.json). 4. Add quran-api to the mcpServers object. For Docker, specify docker as the command with args ["run", "-i", "--rm", "--init", "-e", "API_KEY=your_api_key_if_needed", "-e", "VERBOSE_MODE=true", "quran-mcp-server"]. For Node.js production mode, point the command to node and pass /path/to/quran-mcp-server/dist/src/server.js in args with API_KEY and VERBOSE_MODE environment variables. 5. Restart Claude Desktop to apply the changes.

What you can do with Quran.com API

• Retrieve Quranic verses by chapter, page number, juz, hizb, or verse key directly into LLM prompts for scholarly research. - Search the entire Quranic corpus for specific words, themes, or concepts using the official API v4 search endpoint. - Compare multiple translations and access detailed translation metadata across different target languages for linguistic analysis. - Access tafsir commentaries and theological explanations by specific tafsir IDs to analyze Quranic exegesis in context. - Query available chapter reciters and recitation styles to retrieve audio resource information for multimedia applications.

Key facts

• https://github.com/djalal/quran-mcp-server
• Notes & Knowledge Management, Web Search & Research
• islamic-studies, quran, religious-texts, theology

Part of MCP Servers

How do I install Quran.com API MCP server?

You can install it using either Docker or Node.js 22+. Build the Docker image using docker build -t quran-mcp-server . or compile the project locally using npm run build. Then add the server configuration specifying either the docker command or the node path to your claude_desktop_config.json file and restart your MCP client.

What can Quran.com API MCP server do?

The server exposes tools to query chapters, verses, translations, tafsirs, and audio resources from Quran.com. It allows clients to search terms across the corpus, retrieve verses by page, Juz, or key, fetch random verses, and inspect information on reciters, recitation styles, and supported languages.

Which MCP clients work with Quran.com API?

It works with any Model Context Protocol compliant client, including Claude Desktop. The project documentation provides explicit configuration examples for Claude Desktop using Docker, compiled Node.js files, or development mode via ts-node.

Is Quran.com API MCP server open source?

Yes, Quran.com API MCP server is open source. According to the project documentation, it is licensed under the MIT License and hosted publicly on GitHub.

Does Quran.com API require an API key?

The server supports an optional API_KEY environment variable. If an API key is required by the Quran.com API for your specific usage level, you can supply it through the environment variables in your MCP client configuration.