Getting help.

Contact

Email: hello@divinecreative.org
GitHub issues: github.com/Divine-Creative-Ministries/bible-cli/issues

Use GitHub issues for bugs and feature requests. Issues are public, so use email for anything private.

What to include

• What you did, what you expected, and what happened instead.
• The exact command or tool call, and the full error message.
• Which AI client you were using, if any.
• For the hosted server, the approximate time and time zone of the problem.
• For the command-line tool, the output of the two commands below.

$ bible --version
$ bible doctor

bible doctor checks your platform, SQLite driver, and databases. Run it first when anything misbehaves. Its output includes local file paths, so review it before posting publicly.

Hosted server

The MCP endpoint, for use in an MCP client:

https://mcp.biblecli.org/mcp

To check that the server is up, open the health URL:

https://mcp.biblecli.org/healthz

A healthy server returns {"ok":true,"server":"bible-cli-mcp"}. The hosted server provides 25 read-only tools. It does not include the sql tool or the study_* tools. Those need a local install.

Add the connector

The hosted server needs no account, API key, or install. Menu labels and availability depend on your client’s plan and on any workspace policy your admin has set.

Cursor

The plugin adds the MCP server and the bible-study skill. Copy it into Cursor’s local plugin folder, run Developer: Reload Window, and confirm it appears under Customize:

$ git clone --depth 1 https://github.com/Divine-Creative-Ministries/bible-cli /tmp/bible-cli
$ cp -R /tmp/bible-cli/plugins/bible-cli ~/.cursor/plugins/local/bible-cli

On Enterprise plans, the Allow Local Plugin Imports setting must be on, and it is off by default.

To add only the MCP server, put this in .cursor/mcp.json in a project, or in ~/.cursor/mcp.json for all projects:

{
  "mcpServers": {
    "bible-cli": {
      "url": "https://mcp.biblecli.org/mcp"
    }
  }
}

Grok Bot

If Bible CLI is listed under Connect apps, add it there. Otherwise ask a Bot in chat:

Add this MCP server: https://mcp.biblecli.org/mcp

Grok Bot can add an MCP server that isn’t in its catalog by URL. Once the server is added, type @ in chat to attach it to a task. A team’s connector policy applies, so a blocked server shows Disabled by team admin.

Claude apps

On Free, Pro, Max, and Ultra plans:

1. Go to Customize > Connectors.
2. Select Add custom connector. If you see + Add first, select it, then Add custom connector.
3. Enter a name, such as Bible CLI, and https://mcp.biblecli.org/mcp as the server URL.
4. If asked about authentication, choose No sign-in.
5. Select Add.

The Free plan allows one custom connector. On Team and Enterprise plans, an Owner adds the connector under Organization settings > Connectors by selecting Add, then Custom, then Web if asked for a connector type. Members then select Connect under Customize > Connectors.

ChatGPT

On ChatGPT on the web:

1. Go to ChatGPT Plugins.
2. Select the plus button, then Add custom MCP server.
3. Enter a name, such as Bible CLI.
4. Under Connection, enter https://mcp.biblecli.org/mcp as the server URL.
5. Choose No authentication.
6. Review the risk warning and select I understand and want to continue.
7. Select Create as a plugin.
8. Install the plugin and start a new conversation.
9. Type @ in the prompt box and select the plugin.

Account and workspace policies decide who can add custom MCP servers, so this option may not appear on every account. See OpenAI’s guide.

Local install

bible mcp runs on your own machine over stdio for Claude Desktop, Cursor, and any MCP client. It adds the sql tool and the study_* reading-session tools, for 35 tools in all. In Claude Code:

$ npm install -g @divine-creative-ministries/bible-cli
$ claude mcp add bible -- bible mcp

The docs cover installation and every command.