Setup and reference

Set up Hermo in your AI

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.

Set up

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.

Server address
https://api.hermo.ai/connect-ai/mcp

Claude (desktop app and claude.ai)

  1. Open Settings, then Customize, then Connectors.
  2. Click Add, then Add custom connector.
  3. Name it Hermo and paste the server address.
  4. Click Add, then Connect. Sign in to Hermo and tap Allow.

If you don’t see custom connectors, turn them on first in Settings > Capabilities.

Claude Code

  1. Run this in your terminal: claude mcp add --transport http hermo https://api.hermo.ai/connect-ai/mcp
  2. Claude Code opens your browser once to sign in to Hermo. Tap Allow.
  3. Type /mcp in Claude Code to check Hermo is listed.

ChatGPT

  1. In Settings, go to Connectors, then Advanced, and turn on Developer Mode.
  2. Back in Connectors, create a custom connector called Hermo.
  3. Give it a description such as “Add tasks, habits and lists to my Hermo family planner” and paste the server address.
  4. Save. The first time ChatGPT uses Hermo, sign in and tap Allow.

If you don’t see Developer Mode, your ChatGPT plan or region may not have it yet.

Hermes and other MCP clients

  1. Add a remote MCP server (streamable HTTP) and paste the server address.
  2. The client finds Hermo’s sign-in page by itself and opens it. Sign in and tap Allow.

The client needs to support OAuth sign-in for remote MCP servers. The technical details are below.

Connection details

Server address
https://api.hermo.ai/connect-ai/mcp
Transport
Streamable HTTP
Sign-in
OAuth 2.0 authorization code with PKCE (S256). Open dynamic client registration.
Discovery
https://api.hermo.ai/.well-known/oauth-authorization-server
https://api.hermo.ai/.well-known/oauth-protected-resource
Tokens
Access tokens last one hour. A refresh token comes with every access token, lasts 30 days and changes each time it is used. Hermo stores only a hash of each code and token.
Plan
The Helper plan or above

Permissions

Assistants 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.

PermissionWhat it allows
tasks.readSee the to-dos, the Share board, meals, recipes, lists and school break and weekend plans.
tasks.writeEverything in tasks.read, plus add and change those things.
calendar.readSee the family calendar.
calendar.writeEverything in calendar.read, plus add events.

Tools

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.

ToolWhat it doesType
list_cardsThe 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_ownersEach Share board area and who holds it.Reads only
list_tasksThe household’s to-dos and habits, filtered by date, person, area or status.Reads only
recent_completionsWhat got done in the last few days.Reads only
list_household_membersThe adults, children and carers in the household.Reads only
get_card_mscWhat “done” means for one Share board area.Reads only
get_family_meeting_contextEverything 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_contextEverything for planning a week of meals: the calendar, recipes, recent meals and food notes such as allergies.Reads only
get_recipesThe ingredients and method for chosen recipes.Reads only
preview_week_meal_planShows a proposed week of meals as a table. Saves nothing.Reads only
list_watchersHermo’s reminders for school breaks and weekends, and where each one stands.Reads only
get_watcher_contextWhat one of those reminders already knows: your area, the kids’ ages, your budget and what is booked.Reads only
list_calendar_eventsThe family calendar between two dates, up to 90 days.Reads only
create_listCreates a named list, such as a packing list.Changes something
add_tasksAdds to-dos and habits to the shared list.Changes something
import_listTurns a pasted plan or chore list into to-dos and habits.Changes something
reassign_taskChanges who a to-do is for.Changes something
reschedule_taskMoves a to-do to another day or week.Changes something
complete_taskTicks a to-do off, or records a habit as kept today.Changes something
reassign_cardChanges who holds a Share board area.Changes something
set_card_weekday_rotaSets who does an area on which days of the week.Changes something
set_card_mscSets what “done” means for an area.Changes something
set_week_meal_planSaves a week of meals to the meal plan.Changes something
add_recipe_from_textSaves a recipe from pasted text.Changes something
add_recipe_from_urlFetches a recipe page from the web and saves the recipe.Changes something
add_to_watcher_wishlistSaves a shortlist (for example holiday clubs) so Hermo’s next reminder leads with it.Changes something
record_watcher_bookingRecords something you booked, so Hermo stops suggesting alternatives for those dates.Changes something
delete_taskRemoves a to-do or habit from both parents’ list. There is no undo in Hermo.Cannot be undone from Hermo
add_calendar_eventsAdds events to Google Calendar, up to 20 at a time. Hermo cannot move or delete them afterwards.Cannot be undone from Hermo

What your AI sees, and what it never sees

Your AI can see, when it asks
  • This week’s to-dos, and who’s on each one
  • The family calendar
  • Who holds what on the Share board, and who does which days
  • Meals, recipes and your lists
  • Your plans for half term and weekends: the kids’ ages and interests, your budget, what’s booked
  • Food notes from Familypedia, like allergies, with personal details removed
Your AI never sees, and cannot do
  • Your inbox or any email
  • Any WhatsApp message or group
  • Send, reply to or delete email
  • Move, change or cancel a calendar event
  • Book or pay for anything through 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.

Switch off or disconnect

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.

Help

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.

Try free

The Helper plan and above · Hermo for families