usccb

name	usccb
description	Find Catholic churches, get daily Mass readings, and search Catholic prayers from the United States Conference of Catholic Bishops
version	2.0.0
user-invocable	true
slash-command	usccb
metadata	{"openclaw":{"requires":{"bins":["python3","pip"]},"emoji":"⛪","category":"spiritual","tags":["usccb","bible","catholic","prayers","readings","scripture","mass","church","parish"],"network":true},"parameters":{"type":"object","properties":{"action":{"type":"string","enum":["mass-times","readings","search-prayers","get-prayer"],"description":"'mass-times' to find churches, 'readings' for daily Bible readings, 'search-prayers' to search prayers, 'get-prayer' to retrieve full prayer text"},"location":{"type":"string","description":"Required for mass-times. City, address, or ZIP code to search near"},"date":{"type":"string","description":"Optional for readings. Date in YYYY-MM-DD format (defaults to today)"},"titles":{"type":"array","items":{"type":"string"},"description":"Optional for readings. Filter to return only specific readings (e.g., ['Gospel', 'Reading 1'])"},"query":{"type":"string","description":"Required for search-prayers. Search term for prayers"},"url":{"type":"string","description":"Required for get-prayer. Full URL to the prayer page on USCCB.org"},"page":{"type":"integer","description":"Optional for mass-times. Page number for pagination (default: 1)"},"limit":{"type":"integer","description":"Optional for mass-times and search-prayers. Maximum number of results to return"},"language":{"type":"string","enum":["en","es"],"description":"Optional for search-prayers. Language filter - 'en' for English (default), 'es' for Spanish"},"json_output":{"type":"boolean","description":"Optional for all commands. Set to true to get JSON output instead of markdown (default: false for markdown)"}},"required":["action"]},"examples":[{"prompt":"Find Catholic churches near Boston","call":"usccb","args":{"action":"mass-times","location":"Boston, MA"}},{"prompt":"Where can I go to Mass in New York?","call":"usccb","args":{"action":"mass-times","location":"New York, NY","limit":5}},{"prompt":"What are today's Bible readings?","call":"usccb","args":{"action":"readings"}},{"prompt":"Show me the Mass readings for Christmas 2026","call":"usccb","args":{"action":"readings","date":"2026-12-25"}},{"prompt":"What's the Gospel reading for today?","call":"usccb","args":{"action":"readings","titles":["Gospel"]}},{"prompt":"Find me a prayer about peace","call":"usccb","args":{"action":"search-prayers","query":"peace"}},{"prompt":"Search for Spanish prayers about Mary","call":"usccb","args":{"action":"search-prayers","query":"María","language":"es"}},{"prompt":"Get the Hail Mary prayer","call":"usccb","args":{"action":"search-prayers","query":"Hail Mary","limit":1}}]}

USCCB Skill

Access Catholic churches, daily Mass readings, and prayers from the United States Conference of Catholic Bishops (USCCB) website.

When to use this skill

• User asks to find Catholic churches or Mass times near a location
• User wants to see today's Mass readings or the daily Gospel
• User asks about readings for a specific date or feast day
• User wants to search for Catholic prayers or devotions
• User mentions Catholic liturgy, scripture, Bible readings, or prayers
• User wants to know what the Church is reading today
• User asks about specific prayers like the Rosary, Hail Mary, Our Father, etc.
• User wants prayers in Spanish (oraciones en español)

Scripts

⛪ Mass Times

Find Catholic churches near a location with Mass schedules and contact information.

• Command: ~/.openclaw/skills/usccb_cli/usccbcli mass-times <location> [--page N] [--limit N] [--json]
• Example: ~/.openclaw/skills/usccb_cli/usccbcli mass-times "Boston, MA" --limit 5
• Output: Markdown by default with church info organized by headers and bullet lists. Use --json for structured JSON.
• Markdown format: # header with coordinates, ## for each church, Bold labels for fields, Mass times grouped by day
• JSON fields: location_searched, coordinates, page, total_results, churches array
• Church fields: name, distance, address (street/city/state/postal_code), phone, url, church_worship_times (array), diocese_name
• Note: Churches sorted by distance. Outputs markdown for LLM parsing by default. Use --json for programmatic access.

📖 Daily Bible Readings

Get the complete daily Mass readings including First Reading, Responsorial Psalm, Second Reading (when applicable), Gospel Acclamation, and Gospel.

• Command: ~/.openclaw/skills/usccb_cli/usccbcli readings [--date YYYY-MM-DD] [--titles "Title1" "Title2" ...] [--json]
• Example: ~/.openclaw/skills/usccb_cli/usccbcli readings --date 2026-12-25
• Example (filter): ~/.openclaw/skills/usccb_cli/usccbcli readings --titles "Gospel" "Reading 1"