[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [CCEL commentary catalog](https://spiral.ai/integrations/gemini-cli/ccel-commentary-catalog)

# How to Use CCEL commentary catalog in Gemini CLI

Returns entries from CCEL's commentary catalog. Use it to find relevant titles before choosing a work, especially when your research starts with a Bible book or commentator.

|  |  |
| --- | --- |
| Model | CCEL commentary catalog |
| Available through | Alexandria |
| Category | Industry Data |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with CCEL commentary catalog in Gemini CLI

- Use CCEL commentary catalog to find works relevant to Romans, then create a bibliography page in this project using the returned titles.
- Use CCEL commentary catalog to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from CCEL commentary catalog and tell me what changed since last week.
- Check CCEL commentary catalog and summarize what you find in three bullet points.
- Pull the newest data from CCEL commentary catalog and give me the result as a table.

## How to set up CCEL commentary catalog in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run CCEL commentary catalog**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "ccel-org/bible/list_commentaries",
    "input": {
      "limit": 1
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds CCEL commentary catalog on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## CCEL commentary catalog tools and prices

- [CCEL: classic Bible commentaries, sermons and Christian classics (ccel.org) · List commentaries](https://spiral.ai/tools/alexandria/ccel-org/bible/list_commentaries) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 100 | — | Results per page (default 25). |
| query |  | — | Words that must all appear in the title or author name (prefix match), e.g. "romans", "expositor psalms". |
| author |  | — | Author id or name, e.g. barnes, "MacLaren". |
| cursor |  | — | next_cursor from the previous page. |

## What can you do with CCEL commentary catalog in Gemini CLI?

Build a study reader that connects Bible passages with CCEL readings and historical author context. Use the retrieved material to populate attributed notes and reading lists in your project.

### Prepare a sermon research brief

For John 3, find commentary titles and chapter links, read explanations and historical sermons, and check author backgrounds. Use work contents to locate surrounding material before drafting a brief with attributed interpretations.

### Build a historical interpretation seminar

Create a class session on Romans 8 using commentary excerpts, sermon examples, and commentator biographies. Select works from the catalog and passage index, then use their contents to assign precise sections.

### Write a church study discussion guide

Prepare questions about Psalm 23 from commentary explanations and historical preaching. Include short author introductions and a reading list drawn from the catalog, chapter links, and work contents.

### Research a passage's reception history

Trace how historical commentators and preachers discussed John 3. Establish each author's context, identify relevant works and sections, and distinguish exegetical arguments from sermon applications in an attributed essay.

### Create a commentator bibliography

Collect Albert Barnes' works and identify commentary titles relevant to Romans. Organize the reading list around actual sections rather than inferred chapter titles.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## CCEL commentary catalog in other agents

- [Amp](https://spiral.ai/integrations/amp/ccel-commentary-catalog)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/ccel-commentary-catalog)
- [Claude](https://spiral.ai/integrations/claude-desktop/ccel-commentary-catalog)
- [Claude Code](https://spiral.ai/integrations/claude-code/ccel-commentary-catalog)
- [Cline](https://spiral.ai/integrations/cline/ccel-commentary-catalog)
- [Codex](https://spiral.ai/integrations/codex/ccel-commentary-catalog)
- [Cursor](https://spiral.ai/integrations/cursor/ccel-commentary-catalog)
- [Devin](https://spiral.ai/integrations/devin/ccel-commentary-catalog)
- [dots](https://spiral.ai/integrations/dots/ccel-commentary-catalog)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/ccel-commentary-catalog)
- [Gemini](https://spiral.ai/integrations/gemini/ccel-commentary-catalog)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/ccel-commentary-catalog)
- [goose](https://spiral.ai/integrations/goose/ccel-commentary-catalog)
- [Grok](https://spiral.ai/integrations/grok/ccel-commentary-catalog)
- [Grok Build](https://spiral.ai/integrations/grok-build/ccel-commentary-catalog)
- [Hermes](https://spiral.ai/integrations/hermes/ccel-commentary-catalog)
- [Instinct](https://spiral.ai/integrations/instinct/ccel-commentary-catalog)
- [Manus](https://spiral.ai/integrations/manus/ccel-commentary-catalog)
- [Muse](https://spiral.ai/integrations/muse/ccel-commentary-catalog)
- [Muse Code](https://spiral.ai/integrations/muse-code/ccel-commentary-catalog)
- [n8n](https://spiral.ai/integrations/n8n/ccel-commentary-catalog)
- [Notion](https://spiral.ai/integrations/notion/ccel-commentary-catalog)
- [OpenClaw](https://spiral.ai/integrations/openclaw/ccel-commentary-catalog)
- [opencode](https://spiral.ai/integrations/opencode/ccel-commentary-catalog)
- [Perplexity](https://spiral.ai/integrations/perplexity/ccel-commentary-catalog)
- [Raycast](https://spiral.ai/integrations/raycast/ccel-commentary-catalog)
- [VS Code](https://spiral.ai/integrations/vscode/ccel-commentary-catalog)
- [Windsurf](https://spiral.ai/integrations/windsurf/ccel-commentary-catalog)
- [Zapier](https://spiral.ai/integrations/zapier/ccel-commentary-catalog)

## More Gemini CLI guides

- [CCEL author biography and works](https://spiral.ai/integrations/gemini-cli/ccel-author-biography-and-works)
- [CCEL commentary links by Bible chapter](https://spiral.ai/integrations/gemini-cli/ccel-commentary-links-by-bible-chapter)
- [CCEL Bible passage commentary](https://spiral.ai/integrations/gemini-cli/ccel-bible-passage-commentary)
- [CCEL sermon links by Bible passage](https://spiral.ai/integrations/gemini-cli/ccel-sermon-links-by-bible-passage)
- [Bible Hub verse commentaries](https://spiral.ai/integrations/gemini-cli/bible-hub-verse-commentaries)
- [CCEL work section text](https://spiral.ai/integrations/gemini-cli/ccel-work-section-text)

## Questions about CCEL commentary catalog in Gemini CLI

**Can Gemini CLI use CCEL commentary catalog?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run CCEL commentary catalog like any built-in tool.

**How much does CCEL commentary catalog cost in Gemini CLI?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need an Alexandria account to use CCEL commentary catalog in Gemini CLI?**

No. Spiral runs CCEL commentary catalog on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up CCEL commentary catalog in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while CCEL commentary catalog runs?**

CCEL commentary catalog runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

**How broad is CCEL's collection?**

CCEL describes a library of hundreds of classic Christian books selected for education and edification. Its coverage extends beyond Bible commentary to Christian literature.

**Why might an author be missing?**

CCEL says it may be unable to find a public-domain edition. An absent author therefore does not establish that the author never wrote about your subject.

**Does CCEL correct historical authors' arguments?**

CCEL says it leaves book contents unchanged even when it believes them to be in error. Read an interpretation as that author's argument rather than a corrected editorial conclusion.

**Are passage commentary results organized by individual verse?**

The commentary discovery index follows CCEL's chapter indexing. A chapter result helps locate relevant works, but you still need to read the linked section to establish what it says about a particular verse.

**What historical context can CCEL provide about a commentator?**

Author pages include biography and works. For example, Albert Barnes' page records his birth in Rome, New York, on December 1, 1798, and lists his biblical commentaries.

