Guide

A Catholic MCP server for your AI agent: liturgy, Scripture, and Mass times

Connect Claude, ChatGPT, Codex, Cursor, VS Code, or Gemini CLI to Gianna's MCP server for checked Catholic data and your own novenas, reminders, and prayer list.

mcpai agentsclaudechatgptcodexdevelopers

Updated 2026-10-17 · View resource

General AI models know a lot about the Catholic faith and get the details wrong: a line missing from the Memorare, Ascension Thursday on the wrong day, a Mass time that was never published. Gianna runs an MCP server at https://gianna.chat/mcp that gives any AI agent the checked answer, with its source.

What your agent can look up

The liturgy

Scripture and prayer

Church teaching

Churches and the wider Church

What your agent can do for you

With your permission, the agent can act on your Gianna household:

Gianna then delivers the reminders and the day's novena prayer on the web, by email, or on Telegram, whether or not the agent is running.

Anything that would share your details with someone else, such as asking to join a parish group, waits for your approval. Gianna emails you and nothing is sent until you approve it.

Built for agents

The full tool list and result fields are in Gianna for AI agents.

Connect it

Claude (web and desktop): Settings, Connectors, Add custom connector, then enter https://gianna.chat/mcp.

ChatGPT: turn on Developer mode in Settings, Security and login, open Plugins, choose +, and enter https://gianna.chat/mcp.

Codex:

codex mcp add gianna --url https://gianna.chat/mcp
codex mcp login gianna

Claude Code, with an API key from Settings, Developer access:

claude mcp add --transport http gianna https://gianna.chat/mcp \
  --header "Authorization: Bearer $GIANNA_API_KEY"

Cursor, VS Code, Gemini CLI, and any other client using the Streamable HTTP transport connect the same way, with OAuth 2.1 sign-in or a bearer key. An agent with no browser can sign you in with a short code through the OAuth device flow; give it https://gianna.chat/onboard.md.

The Gianna skill

The skill at /skill.md tells an agent when to use these tools and how: quote prayers exactly, cite the source of a Mass time, and check that an action succeeded. Save it as ~/.claude/skills/gianna/SKILL.md for Claude Code or ~/.agents/skills/gianna/SKILL.md for Codex.

Things to ask

"What feast is it on Sunday, and what colour are the vestments?"

"Give me the Apostles' Creed in Latin."

"Is the Ascension a holy day of obligation in England and Wales this year?"

"When is Confession at St Mary's in Cambridge this Saturday?"

"Start the novena to St Joseph and remind me at 7am each day."

What it costs

The Catholic reference tools are free with a Gianna account: the liturgy, Scripture, prayers, Church teaching, churches, saints, relics, lineage, groups, and jobs. Acting on a household needs a plan. The Terms do not allow reselling the data or copying it in bulk.

Price and the early-bird offer

The early-bird offer gives half price for your first year. Standard is $5 a month or $40 a year, normally $10 or $80. Pro, with voice notes and photo reading, is $10 a month or $80 a year, normally $20 or $160. One subscription covers the household, the first seven days are free, and nothing is charged during the trial. Prices checked on 17 October 2026; see gianna.chat for current terms, or start the free trial.

Connect your agent · Create an account