Answers questions about a Bible passage, person, or topic with background, key verses, and application. Use when the user asks about a scripture reference, c...
25 installs1 stars
Design & media
Hey Bible
Try itLook up, search, and reference Bible verses and Scripture via the Hey Bible API. Use when the user asks to find, quote, look up, or cross-reference Bible ver...
What it does
Look up, search, and reference Bible verses and Scripture via the Hey Bible API. Use when the user asks to find, quote, look up, or cross-reference Bible verses, passages, chapters, or translations, or to read their saved Hey Bible favorites, notes, verse images, or chats. Returns Scripture text and structured JSON.
The skill document
Hey Bible
Give your agent first-class access to the Bible. Look up verses across multiple translations, browse the books of Scripture, and read the user's saved Hey Bible data (favorites, notes, AI-generated verse images, and chats) — all returned as clean, structured JSON.
This skill is powered by the @hey-bible/cli
package, a thin wrapper over the Hey Bible API.
Setup
The user needs a Hey Bible API key, available from heybible.app under Account > API Keys. Set it as an environment variable:
export HEY_BIBLE_API_KEY=your_api_key_here
Method 1: CLI (preferred)
Use the hey-bible CLI via npx. No install required. Always pass --json
so the output is structured and easy to parse.
# Look up a verse or range (defaults to ESV)
npx -y @hey-bible/cli search John 3 --start-verse 16 --end-verse 18 --json
# Look up a whole chapter
npx -y @hey-bible/cli search Genesis 1 --json
# List available translations, then look up in a specific one
npx -y @hey-bible/cli bibles --json
npx -y @hey-bible/cli search Psalms 23 --bible-id kjv --json
# List the books of the Bible (names, 3-letter codes, chapter counts)
npx -y @hey-bible/cli books --json
Reading the user's saved data
# Favorited verses (optionally filtered by tag)
npx -y @hey-bible/cli favorites --json
npx -y @hey-bible/cli favorites --tag faith --limit 10 --json
# Notes, AI-generated images, chats, and tags
npx -y @hey-bible/cli notes --json
npx -y @hey-bible/cli images --json
npx -y @hey-bible/cli images --id 42 --json # returns a 24h signed URL
npx -y @hey-bible/cli chats --json
npx -y @hey-bible/cli tags --json
Commands
| Command | Description |
|---|---|
search | Look up verses. Options: --start-verse, --end-verse, --bible-id. Saves the lookup to the user's account. |
bibles | List available Bible translations (id, name, abbreviation, source). |
books | List the 66 books with 3-letter codes and chapter counts. |
favorites | List favorited verses with their notes, images, conversations, and tags. Options: --tag, --limit, --offset. |
notes | List verse notes. Options: --id, --limit, --offset. |
images | List AI-generated verse images. --id returns a signed URL. |
chats | List chat conversations with verse context. Options: --id, --limit, --offset. |
tags | List the user's tags. |
Notes
- Verse
contentis returned as HTML (with `` verse numbers) inside the JSON. Strip tags when presenting the text to the user. - The API is read-oriented.
searchis the only call with a side effect: it saves the looked-up passage to the user's Hey Bible account. - Book names accept natural forms like
"John","Genesis", and"1 Corinthians". Quote multi-word book names in the shell.
See references/api-reference.md for the full
endpoint and field reference.
Related skills
Produces a sermon outline from a scripture passage or theme, ready for preaching. Use when the user asks for a sermon outline, preaching structure, or exposi...
21 installs
Produces full, readable pastoral prayers for specific scenarios (illness, thanksgiving, worship, funeral, wedding, baptism, etc.). Use when the user asks for...
20 installs1 stars
Run deep, multi-source research queries via the kenkyu API and get back a cited answer with sources. Use for any question that benefits from a thorough, sourced investigation rather than a quick answer.
靈性陪伴對話技能：以耶穌的愛與教導回應信仰困惑、禱告請求、心靈痛苦、人生迷茫與聖經故事講解。溫柔傾聽、以提問引導，支援18種語言。
Researches books, authors, and audiobooks via the Crawlora API — Goodreads (books, authors, reviews, lists, quotes), Apple Books (books, audiobooks, series, reviews, charts), and Audible (audiobook catalog search, product detail, narrators/series, reviews, charts, editorial lists) — returning clean JSON. Use when the user wants a book's ratings/reviews, an author's bibliography, curated reading lists, or audiobook details and charts.
1 installs