Hermo runs an MCP server. Add it to Claude, ChatGPT, Hermes or any MCP client, sign in with your Hermo account, and your AI can see your family’s week and add to it, where both parents see the result. This page has the steps for each assistant and everything your AI can do through Hermo. Connecting an assistant needs the Helper plan or above.
Every assistant uses the same server address. The first time it connects, a Hermo page opens: sign in, check what it will be able to do, tick Read only if you want it to look but not change anything, and tap Allow.
https://api.hermo.ai/connect-ai/mcpIf you don’t see custom connectors, turn them on first in Settings > Capabilities.
claude mcp add --transport http hermo https://api.hermo.ai/connect-ai/mcp/mcp in Claude Code to check Hermo is listed.If you don’t see Developer Mode, your ChatGPT plan or region may not have it yet.
The client needs to support OAuth sign-in for remote MCP servers. The technical details are below.
https://api.hermo.ai/connect-ai/mcphttps://api.hermo.ai/.well-known/oauth-authorization-serverhttps://api.hermo.ai/.well-known/oauth-protected-resourceAssistants ask for tasks.write calendar.write unless they ask for less. Choosing Read only gives tasks.read calendar.read instead. Hermo ignores any other permission it is asked for.
| Permission | What it allows |
|---|---|
tasks.read | See the to-dos, the Share board, meals, recipes, lists and school break and weekend plans. |
tasks.write | Everything in tasks.read, plus add and change those things. |
calendar.read | See the family calendar. |
calendar.write | Everything in calendar.read, plus add events. |
Every tool carries MCP annotations: readOnlyHint on the 13 that only read, and destructiveHint on the two that cannot be undone from Hermo. Hermo tells your AI to read back every change and get your yes before making it.
| Tool | What it does | Type |
|---|---|---|
list_cards | The areas on the Share board (for example school runs or meals), so a to-do can be filed under the right one. | Reads only |
list_cards_with_owners | Each Share board area and who holds it. | Reads only |
list_tasks | The household’s to-dos and habits, filtered by date, person, area or status. | Reads only |
recent_completions | What got done in the last few days. | Reads only |
list_household_members | The adults, children and carers in the household. | Reads only |
get_card_msc | What “done” means for one Share board area. | Reads only |
get_family_meeting_context | Everything for a family meeting in one go: who is in the household, every area and who holds it, and the open to-dos. | Reads only |
get_meal_planning_context | Everything for planning a week of meals: the calendar, recipes, recent meals and food notes such as allergies. | Reads only |
get_recipes | The ingredients and method for chosen recipes. | Reads only |
preview_week_meal_plan | Shows a proposed week of meals as a table. Saves nothing. | Reads only |
list_watchers | Hermo’s reminders for school breaks and weekends, and where each one stands. | Reads only |
get_watcher_context | What one of those reminders already knows: your area, the kids’ ages, your budget and what is booked. | Reads only |
list_calendar_events | The family calendar between two dates, up to 90 days. | Reads only |
create_list | Creates a named list, such as a packing list. | Changes something |
add_tasks | Adds to-dos and habits to the shared list. | Changes something |
import_list | Turns a pasted plan or chore list into to-dos and habits. | Changes something |
reassign_task | Changes who a to-do is for. | Changes something |
reschedule_task | Moves a to-do to another day or week. | Changes something |
complete_task | Ticks a to-do off, or records a habit as kept today. | Changes something |
reassign_card | Changes who holds a Share board area. | Changes something |
set_card_weekday_rota | Sets who does an area on which days of the week. | Changes something |
set_card_msc | Sets what “done” means for an area. | Changes something |
set_week_meal_plan | Saves a week of meals to the meal plan. | Changes something |
add_recipe_from_text | Saves a recipe from pasted text. | Changes something |
add_recipe_from_url | Fetches a recipe page from the web and saves the recipe. | Changes something |
add_to_watcher_wishlist | Saves a shortlist (for example holiday clubs) so Hermo’s next reminder leads with it. | Changes something |
record_watcher_booking | Records something you booked, so Hermo stops suggesting alternatives for those dates. | Changes something |
delete_task | Removes a to-do or habit from both parents’ list. There is no undo in Hermo. | Cannot be undone from Hermo |
add_calendar_events | Adds events to Google Calendar, up to 20 at a time. Hermo cannot move or delete them afterwards. | Cannot be undone from Hermo |
Hermo sends your AI only what a tool asks for, and only from your own household. The company that runs your AI handles what it receives under its own privacy policy. Hermo’s side is in the privacy policy.
In Hermo, go to Settings > Assistant. You can switch off any part for each assistant, or disconnect it. Disconnecting stops its access straight away. Anything it added stays in Hermo as ordinary household data, and you can edit or delete it like anything else.
Email hello@hermo.ai for help connecting, and privacy@hermo.ai for anything about your data. For what people plan with Hermo connected, see Connect your AI.
The Helper plan and above · Hermo for families