Trevato/bible-mcp

A Model Context Protocol server that exposes Bible content from bible-api.com for Large Language Models like Claude.
## Features
Access Bible verses and chapters as resources
Tools for retrieving verses by reference and getting random verses
Support for multiple translations
Prompt templates for Bible study
True random verse generation from any book in the Bible
Testament filtering (OT/NT) for random verses
Comprehensive error handling
## Add to Claude config
"Bible MCP": {
"command": "uvx",
"args": [
"bible-mcp"
## Installation
### From PyPI (recommended)
The simplest way to install Bible MCP is via pip:
bash
pip install bible-mcp
### From Source
Clone the repository and install dependencies:
bash
git clone https://github.com/trevato/bible-mcp.git
cd bible-mcp
pip install -e .
Requirements:
Python 3.10+
Dependencies are managed via pyproject.toml
## Usage
### Running with MCP Development Tools
The fastest way to test the server is with the MCP Inspector:
bash
mcp dev bibleserver.py
This will run the server and open a web interface for testing.
### Installing in Claude Desktop
To use this server with Claude Desktop:
bash
mcp install bibleserver.py
After installation, you can access Bible content in your Claude conversations.
### Direct Execution
You can also run the server directly:
bash
python -m bibleserver
## Available Resources
Bible MCP provides the following resources:
### Chapter Resource
bible://{translation}/{book}/{chapter}
Example: bible://web/JHN/3 (John chapter 3 from the World English Bible)
### Verse Resource
bible://{translation}/{book}/{chapter}/{verse}
Example: bible://kjv/JHN/3/16 (John 3:16 from the King James Version)
### Random Verse Resource
bible://random/{translation}
Example: bible://random/web (Random verse from the World English Bible)
## Available Tools
### Get Verse by Reference
python
getversebyreference(reference: str, translation: str = "web") -> str
Parameters:
reference: Bible reference (e.g., "John 3:16", "Matthew 5:1-10")
translation: Translation ID (default: "web")
Example:
getversebyreference("Psalm 23:1", "kjv")
### Get Random Verse
python
getrandomversetool(translation: str = "web", testament: Optional[str] = None) -> str
Parameters:
translation: Translation ID (default: "web")
testament: Optional filter for "OT" (Old Testament) or "NT" (New Testament)
Example:
getrandomversetool(translation="web", testament="NT")
### List Available Translations
python
listavailabletranslations() -> str
Returns a formatted list of all available Bible translations.
## Prompts
### Analyze Verse Prompt
python
analyzeverseprompt(reference: str) -> str
Creates a prompt for analyzing a specific Bible verse.
Example:
analyzeverseprompt("John 3:16")
### Find Verses on Topic Prompt
python
findversesontopicprompt(topic: str) -> str
Creates a prompt for finding verses on a specific topic.
Example:
findversesontopicprompt("love")
## Supported Translations
Bible MCP supports multiple translations through the bible-api.com service: