Gospel Library MCP Server

Unofficial tool. Not affiliated with or endorsed by The Church of Jesus Christ of Latter-day Saints. See DISCLAIMER.md for full details.

An MCP (Model Context Protocol) server that gives AI agents direct, structured access to the Church of Jesus Christ Gospel Library — scriptures, General Conference talks, handbooks, manuals, and magazines.

Compatible with any MCP-enabled AI agent, including GitHub Copilot CLI, Claude Desktop, Claude Code, Cursor, Windsurf, and others.

No API key required. No external service. Everything runs locally.

Search is powered by a local semantic vector index using the all-MiniLM-L6-v2 model. When the index is built, the agent finds articles by meaning — not just URL keywords. Content is served in your OS locale language automatically, with per-request language override support.

---

Requirements

• Node.js ≥ 18
• Any MCP-compatible AI agent (see setup below)

---

Quick Setup

The MCP server configuration format is the same across all agents. Pick your agent below.

GitHub Copilot CLI

Add to ~/.copilot/mcp-config.json (create if it doesn't exist):

{
  "mcpServers": {
    "gospel-library": {
      "command": "npx",
      "args": ["-y", "@jasonbellz/gospel-library-mcp"]
    }
  }
}

Restart Copilot CLI and run /mcp — you should see gospel-library listed with 4 tools.

Claude Desktop

Add to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gospel-library": {
      "command": "npx",
      "args": ["-y", "@jasonbellz/gospel-library-mcp"]
    }
  }
}

Restart Claude Desktop. The tools will be available automatically.

Claude Code (CLI)

claude mcp add gospel-library -- npx -y @jasonbellz/gospel-library-mcp

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-level):

{
  "mcpServers": {
    "gospel-library": {
      "command": "npx",
      "args": ["-y", "@jasonbellz/gospel-library-mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gospel-library": {
      "command": "npx",
      "args": ["-y", "@jasonbellz/gospel-library-mcp"]
    }
  }
}

Other MCP-Compatible Agents

Any agent that supports the MCP stdio transport uses the same mcpServers JSON block. Consult your agent's documentation for the config file location.

(Optional) Add Agent Instructions for Proactive Use

Tell your agent to use the Gospel Library tools automatically when answering Church-related questions. Add the following to your agent's system prompt or instructions file:

## Gospel Library MCP

You have access to an MCP server (`gospel-library`) that provides structured access to the
Church of Jesus Christ of Latter-day Saints Gospel Library at churchofjesuschrist.org.

Use the Gospel Library MCP tools whenever the user asks about:
- Church doctrine, teachings, or gospel principles
- Scriptures (Bible, Book of Mormon, Doctrine & Covenants, Pearl of Great Price)
- General Conference talks (1971–present)
- Church policies, handbooks, or guidelines
- Church history or historical documents
- Magazines (Liahona, Ensign, Friend, New Era)
- Church manuals or curriculum

When a question is clearly about Church topics, call the relevant tool FIRST before answering.

• GitHub Copilot CLI: add to ~/.copilot/copilot-instructions.md
• Claude Desktop / Claude Code: add to your project's CLAUDE.md or system prompt
• Cursor: add to .cursorrules or project instructions

---

Building the Semantic Search Index

Without the index, search falls back to URL slug matching (still useful, just less precise). For semantic search — which finds articles by meaning rather than exact keywords — you need a local index.

Three options are available, from fastest to most thorough:

Option	Command	Size	Time	Quality
Download (pre-built)	download-index	~12.5 MB	~30 sec	Good
Standard build (truncated)	build-index	~12–13 MB	~45–90 min	Good
Full build (chunked)	build-index --full	~35–40 MB	~2–4 hrs	Best
Download full (pre-built chunked)	download-index --full	~35–40 MB	~1–2 min	Best

Option 1: Download the Pre-Built Index (Recommended, ~30 seconds)

Download a pre-built index.db from the latest GitHub Release:

npx @jasonbellz/gospel-library-mcp download-index

Saves to ~/.gospel-library-mcp/index.db. Shows live download progress.

Option 2: Download the Pre-Built Full Index (~1–2 minutes)

Download the pre-built chunked index for best semantic coverage:

npx @jasonbellz/gospel-library-mcp download-index --full

Saves to ~/.gospel-library-mcp/index.db (replaces any existing index).

Option 3: Build the Standard Index Locally (~45–90 minutes)

Build from scratch by crawling the live sitemap. Each article is indexed using its full content, truncated to ~350 words (one embedding per article).

npx @jasonbellz/gospel-library-mcp build-index

What it does:

• Downloads the English sitemaps (~50k URLs)
• Filters to indexed categories: General Conference talks, General Handbook, Gospel Topics essays (~10,000+ pages)
• Fetches and parses each page, using the first ~350 words as the embed text
• Generates 384-dimension embeddings using Xenova/all-MiniLM-L6-v2 (runs locally, ~25 MB download on first run)
• Stores everything in ~/.gospel-library-mcp/index.db

Option 4: Build the Full Chunked Index Locally (~2–4 hours)

Build a deeper index where each article is split into overlapping ~350-word chunks. Produces multiple embeddings per article for full semantic coverage of long talks and handbook sections.

npx @jasonbellz/gospel-library-mcp build-index --full

When to use: When you want the best possible search quality and are willing to wait for the longer build. Especially useful for finding specific passages within long articles.

Refreshing After New Content

New General Conference talks are published in April and October. Run an incremental refresh — only new articles are fetched and embedded. The refresh automatically detects whether your current index is standard or full and uses the same mode:

npx @jasonbellz/gospel-library-mcp refresh

Expected time: 1–5 minutes (a few hundred new articles per conference)

The MCP server automatically reminds you to refresh when the index is more than 30 days old.

---

Tools

search_gospel_library

Search the Gospel Library for articles, talks, scriptures, manuals, and policies.

When the index is built: uses cosine similarity over the local vector index for semantic search — finds articles by meaning. Before the index is built: falls back to URL slug keyword matching.

Parameter	Type	Required	Description
query	string	✅	The search query (e.g. 'faith hope charity', 'word of wisdom')
category	string	❌	Restrict results to a category. See Category Aliases below
maxResults	number	❌	Max results to return (1–10, default 5)

Category aliases (pass these as the category parameter):

Alias	Resolves to
general-conference	All General Conference talks
scriptures	All scripture content
manual	All manuals and handbooks
handbooks	General Handbook only
liahona	Liahona magazine
ensign	Ensign magazine
friend	Friend magazine

You can also pass any path relative to /study/ (e.g. general-conference/2024/10).

---

get_article

Fetch the full content of a specific article, talk, manual chapter, or policy page. Returns clean markdown.

Parameter	Type	Required	Description
url	string	✅	Full https://www.churchofjesuschrist.org/... URL
lang	string	❌	Language code (e.g. 'spa', 'por', 'fra'). Defaults to OS locale

Example URL: https://www.churchofjesuschrist.org/study/general-conference/2024/10/12andersen?lang=eng

---

browse_category

List all articles and talks in a category or collection. Returns titles and URLs. Useful for browsing a specific conference session, scripture book, or magazine issue.

Parameter	Type	Required	Description
category	string	✅	Path relative to /study/ — see table below
lang	string	❌	Language code (e.g. 'spa', 'por', 'fra'). Defaults to OS locale

Common category paths:

Content	Path
All General Conferences	general-conference
October 2024 Conference	general-conference/2024/10
April 2025 Conference	general-conference/2025/04
Book of Mormon	scriptures/bofm
New Testament	scriptures/nt
Old Testament	scriptures/ot
Doctrine & Covenants	scriptures/dc-testament
Pearl of Great Price	scriptures/pgp
General Handbook	manual/general-handbook
Gospel Topics	manual/gospel-topics
Liahona (current)	liahona

---

get_scripture

Fetch a specific scripture passage by reference. Parses the reference, constructs the Gospel Library URL, and returns the chapter content as markdown.

Parameter	Type	Required	Description
reference	string	✅	Scripture reference (e.g. 'John 3:16', '2 Nephi 2:25', 'D&C 76:22')
lang	string	❌	Language code (e.g. 'spa', 'por', 'fra'). Defaults to OS locale

Supported reference formats:

• Full chapter: Genesis 1, Alma 32
• Single verse: John 3:16, Moroni 10:4
• Verse range: Moroni 10:4-5, D&C 76:22-24

Supported books and abbreviations:

<details> <summary>Old Testament</summary>

Book	Abbreviations
Genesis	Gen
Exodus	Ex
Leviticus	Lev
Numbers	Num
Deuteronomy	Deut
Joshua	Josh
Judges	Judg
Ruth	—
1 Samuel	1 Sam
2 Samuel	2 Sam
1 Kings	1 Kgs
2 Kings	2 Kgs
1 Chronicles	1 Chr
2 Chronicles	2 Chr
Ezra	—
Nehemiah	Neh
Esther	—
Job	—
Psalms	Psalm, Ps
Proverbs	Prov
Ecclesiastes	Eccl
Song of Solomon	—
Isaiah	Isa
Jeremiah	Jer
Lamentations	—
Ezekiel	Ezek
Daniel	Dan
Hosea	—
Joel	—
Amos	—
Obadiah	—
Jonah	—
Micah	—
Nahum	—
Habakkuk	—
Zephaniah	—
Haggai	—
Zechariah	Zech
Malachi	—
</details>

<details> <summary>New Testament</summary>

Book	Abbreviations
Matthew	Matt
Mark	—
Luke	—
John	—
Acts	—
Romans	Rom
1 Corinthians	1 Cor
2 Corinthians	2 Cor
Galatians	Gal
Ephesians	Eph
Philippians	Philip
Colossians	Col
1 Thessalonians	1 Thes
2 Thessalonians	2 Thes
1 Timothy	1 Tim
2 Timothy	2 Tim
Titus	—
Philemon	—
Hebrews	Heb
James	—
1 Peter	1 Pet
2 Peter	2 Pet
1 John	1 Jn
2 John	2 Jn
3 John	3 Jn
Jude	—
Revelation	Rev
</details>

<details> <summary>Book of Mormon</summary>

Book	Abbreviations
1 Nephi	1 Ne
2 Nephi	2 Ne
Jacob	—
Enos	—
Jarom	—
Omni	—
Words of Mormon	—
Mosiah	—
Alma	—
Helaman	Hel
3 Nephi	3 Ne
4 Nephi	4 Ne
Mormon	Morm
Ether	—
Moroni	Moro
</details>

<details> <summary>Doctrine & Covenants / Pearl of Great Price</summary>

Book	Abbreviations
Doctrine and Covenants	D&C, DC
Moses	—
Abraham	Abr
Joseph Smith History	JS-H
Joseph Smith Matthew	JS-M
Articles of Faith	A of F
</details>

---

Multilingual Support

The MCP server automatically detects your OS locale at startup and serves content in that language. No configuration required.

How it works:

• Search always uses the English index (cross-lingual retrieval — the embedding model is multilingual)
• Content (get_article, browse_category, get_scripture) is served in your OS locale language by default
• Every tool accepts an optional lang parameter to override per-request

Override language per-request:

"Read Alma 32 in Spanish" → get_scripture(reference: "Alma 32", lang: "spa")

"Get that talk in Portuguese" → get_article(url: "...", lang: "por")

Supported language codes:

Code	Language	Code	Language
eng	English	spa	Spanish
por	Portuguese	fra	French
deu	German	ita	Italian
jpn	Japanese	kor	Korean
zhs	Chinese (Simplified)	zht	Chinese (Traditional)
rus	Russian	tgl	Filipino / Tagalog
nld	Dutch	swe	Swedish
nor	Norwegian	dan	Danish
fin	Finnish	pol	Polish
ukr	Ukrainian	hun	Hungarian
ces	Czech	ron	Romanian
bul	Bulgarian	ell	Greek
tur	Turkish	ara	Arabic
heb	Hebrew	tha	Thai
ind	Indonesian	msa	Malay
vie	Vietnamese	khm	Khmer
mya	Burmese	mon	Mongolian
smo	Samoan	ton	Tongan
haw	Hawaiian	mao	Māori

Note: Not all content is available in every language. English content is the most complete.

---

Files Created on Your System

Path	Purpose
~/.gospel-library-mcp/index.db	SQLite vector index — standard (~12–13 MB) or full chunked (~35–40 MB)
~/.cache/huggingface/	Cached embedding model (~25 MB, downloaded once on first build-index)

Agent config files (you create these — see Quick Setup above):

Agent	Config file
GitHub Copilot CLI	~/.copilot/mcp-config.json
Claude Desktop (macOS)	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)	%APPDATA%\Claude\claude_desktop_config.json
Cursor	~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json

---

Usage Examples

Semantic search:

"What does the Church teach about the Word of Wisdom?"

Finds articles about dietary law, health, and the Word of Wisdom — even articles where those words don't appear in the URL.

Scripture lookup:

"What does Moroni 10:4-5 say?"

Uses get_scripture to fetch the passage directly.

Browse a conference:

"List the talks from October 2024 General Conference"

Uses browse_category with general-conference/2024/10.

Read Church policy:

"What is the Church's policy on fast offerings?"

Uses search_gospel_library to find the relevant General Handbook section, then get_article to read it.

---

Local Development

git clone https://github.com/jasonbellz/gospel-library-mcp
cd gospel-library-mcp
npm install
npm run build

Then add dist/index.js as the command in your agent's MCP config:

{
  "mcpServers": {
    "gospel-library": {
      "command": "node",
      "args": ["/path/to/gospel-library-mcp/dist/index.js"]
    }
  }
}

Or use node setup.js to auto-register with GitHub Copilot CLI, or node setup.js --npx to register using the published npm package.

Publishing a New Version

# 1. Bump version in package.json (e.g. 2.0.1)
npm version patch   # or minor / major

# 2. Publish (build runs automatically via prepublishOnly)
npm publish --access public

# 3. Commit and push
git add package.json package-lock.json
git commit -m "chore: bump to vX.Y.Z"
git push

---

Disclaimer

This project is an independent, unofficial tool and is not affiliated with, endorsed by, or sponsored by The Church of Jesus Christ of Latter-day Saints.

The Church of Jesus Christ of Latter-day Saints, Book of Mormon, Liahona, Mormon, LDS, CTR, and FamilySearch are trademarks of The Church of Jesus Christ of Latter-day Saints or Intellectual Reserve, Inc., and may be registered in the United States of America and other countries. Use of these marks does not imply endorsement by or affiliation with The Church of Jesus Christ of Latter-day Saints.

All Gospel Library content accessed through this tool is the property of The Church of Jesus Christ of Latter-day Saints or Intellectual Reserve, Inc. This tool provides a programmatic interface to publicly accessible content at churchofjesuschrist.org and does not host, copy, or redistribute that content.

See DISCLAIMER.md for full details. For official trademark guidelines, visit churchofjesuschrist.org/reference/trademark-guidelines.

---

License

MIT © 2026 Jason Bell