Connection guide

Connect your AI to mutqin

Pick your app and follow its steps. No mutqin installation required, and no mutqin account.

The mutqin link

https://mutqin.dev/mcp

Claude

In claude.ai and the Claude desktop app, or in Claude Code.

claude.ai and the desktop app

Available on every plan; the Free plan allows one custom connector. On Team and Enterprise an owner adds it under Organization settings, then Connectors, and each member clicks Connect. A connector on your account also shows up in the desktop app.

  1. Open Customize, then Connectors.
  2. Click "+ Add", then "Add custom connector".
  3. Name it mutqin, paste https://mutqin.dev/mcp and click Continue.
  4. Review the detected authentication settings and click Continue.
  5. Under Authentication choose "No sign in", then click Add.
  6. In your chat, open + → Connectors and enable mutqin.
Official guide (claude.ai and the desktop app)
Command-line setup - developers

Claude Code

  1. Run this in your terminal, then type /mcp inside Claude Code to check the connection.
claude mcp add --transport http quran https://mutqin.dev/mcp
Official guide (Claude Code)

ChatGPT

On ChatGPT for the web, on Business, Enterprise and Edu.

ChatGPT on the web

Custom MCP servers work on ChatGPT Business, Enterprise and Edu, on the web. On Business, only workspace admins and owners can add and publish one; on Enterprise and Edu, admins and owners can, and so can members the admins grant permission to.

  1. Open Plugins.
  2. Click +, then "Add custom MCP server".
  3. Enter a name (mutqin) and, optionally, a description.
  4. Under Connection, paste https://mutqin.dev/mcp.
  5. Configure authentication: none, because mutqin needs no sign-in.
  6. Tick "I understand and want to continue".
  7. Click "Create as a plugin", then review the discovered tools.
  8. Install the plugin. Start a new conversation, type @ and choose mutqin.

Developer Mode is not needed.

Official guide (ChatGPT on the web)

Gemini

In the Gemini web app, or from the command line.

The Gemini app

Google says custom apps are available today to people 18 or over in the US, with a personal Google Account (not work or school), with Keep Activity on, and in English only. Outside the US you can’t connect mutqin to the Gemini app yet; use the command line.

  1. Open gemini.google.com on a computer, then Settings, then Connected Apps.
  2. Under Custom apps, paste https://mutqin.dev/mcp (or click "Add a custom app" if you already have one), click Next and follow the steps.
  3. In your prompt, type @ and select mutqin. It then works in the mobile app too.
Official guide (The Gemini app)
Command-line setup - developers

Gemini CLI

  1. Run this command, then type /mcp inside Gemini CLI to check the connection.
gemini mcp add --transport http --scope user quran https://mutqin.dev/mcp

Using Antigravity CLI? Follow its setup below.

Official guide (Gemini CLI)

Antigravity CLI

  1. Add this to ~/.gemini/config/mcp_config.json, then type /mcp to check the connection.
{
  "mcpServers": {
    "quran": {
      "serverUrl": "https://mutqin.dev/mcp"
    }
  }
}
Official guide (Antigravity CLI)

Last step

Check that it works

Start a new conversation and send this request:

A request to try

Use mutqin to retrieve the tafsir of 2:255 and cite its source.

  • You will see the assistant call one of mutqin’s tools before it answers.
  • The answer gives the tafsir text with the book and its author, as mutqin returned them.

If it answers without calling mutqin, see "The assistant answered without using mutqin" below.

If it doesn’t work

The usual snags, each fixed in a line or two.

mutqin doesn’t show up in my connectors

Check that you saved the link exactly as https://mutqin.dev/mcp, then reload the page. In ChatGPT, custom servers only appear on Business, Enterprise and Edu, and a workspace admin may need to add it. The Claude Free plan allows one custom connector only.

The assistant answered without using mutqin

Turn mutqin on in that conversation: in Claude, open + then Connectors; in ChatGPT and Gemini, type @ and choose mutqin. Then name it in your request, for example start with "Use mutqin". A new conversation after connecting works best.

I get an error when connecting

Check that the link starts with https and ends with /mcp, with no extra space or character, and that you chose no sign-in. If the error stays, tell us what you saw.

Contact us

Do I need a mutqin account or key?

No. mutqin asks for no sign-in and no key, which is why you choose no sign-in in the authentication step.

I can’t find custom apps in Gemini

Google says they are only available in the US for now, to people 18 or over, with a personal Google Account, in English. If that isn’t you, use Gemini CLI from the command-line section of the Gemini tab.