Apps and AI assistants

With a key from WuselWall, another app works with your family's data as one person. There are two kinds:

• Automation: reads and adds, for example for Siri on the iPhone or any other app that can call a web address (such as automation apps on Android or Home Assistant). The examples below use Apple's Shortcuts; other apps send the same requests.
• AI assistant: only reads, for an assistant that speaks MCP, such as Claude (see below).

With the Shortcuts app on the iPhone you talk to WuselWall through Siri: "Hey Siri, shopping list" – "What do you need?" – "Milk and two cucumbers" – "Milk and Cucumbers (2×) are on the list." No extra app is needed, only a key from WuselWall.

What a key may do

A key belongs to one person. A shortcut with that key acts as that person: it ticks their tasks and tells their points.

• It can read: the day, the meals, the timetable, who is home, the points.
• It can add: put things on the shopping list and tick one of the person's own tasks.
• It can neither delete nor manage anything: no changing events, no correcting points, no settings. That holds for a guardian's key too.
• A key adds something at most 100 times a day. If a shortcut runs in a loop by mistake, that is where it stops.

Creating a key

1. Open Settings → Advanced → Apps and AI assistants and tap New key.
2. Give it a name, for example "iPhone".
3. As a guardian, choose the person under For whom?. Everyone else creates their own key on their own phone.
4. Tap Create key.

The key is shown only once, together with your server's address. Copy both. Whoever has the key can read and add as that person, so treat it like a password. The Shortcuts app syncs it through iCloud to your other Apple devices.

The first shortcut: shopping list

1. Open the Shortcuts app and tap +.
2. Add the action Ask for Input. Question: "What do you need?"
3. Add Get Contents of URL:
   • URL: the address from WuselWall with /shopping at the end, for example https://api.example.org/functions/v1/shortcuts/shopping
   • Method: POST
   • Headers: key Authorization, value Bearer (with a space) followed by your key
   • Request Body: JSON, field text with the value Provided Input
4. Add Show Result (or Speak Text if Siri should read the answer aloud).
5. Name the shortcut Shopping list. From now on, "Hey Siri, shopping list" is enough.

WuselWall understands amounts: "2 litres of milk" becomes milk with "2 l", "3 apples" becomes apples (3×). Separate several things with "and" or a comma. Something already on the list is counted up instead of added twice.

Every shortcut

Every shortcut is built like the one above: Get Contents of URL with method POST, the Authorization header and a JSON body. Only the end of the address and the fields change.

Shortcut	Address ends in	Fields in the JSON	Answer, for example
Shopping list	/shopping	text: what goes on the list; list: a list other than the default one (optional)	"Milk is on the list."
What's on today?	/today	day: "tomorrow", a weekday or a date (optional)	"Today: 08:30 Dentist (Olivia). Meals today: Dinner: Spaghetti."
What's for dinner?	/meals	day (optional)	"Meals today: Dinner: Spaghetti. Sarah is cooking."
My points	/points	–	"You have 42 points."
Task done	/chore	text: which task	"Done: Empty the dishwasher. 2 points added."
School	/school	text: the question, such as "Does Olivia have PE tomorrow?"	"Yes, Olivia has PE tomorrow, period 3 (09:55–10:40)."
When is … back?	/presence	text: the question, such as "When is Sarah back?"	"Sarah is travelling until Friday 23 October and back on Saturday 24 October."

For School and When is … back?, let the shortcut Ask for Input first, as for shopping, and send the whole question as text. WuselWall finds the name, the day and the subject in it; the subject is matched by the name your timetable gives it. Without a day, School means the next day, because packing usually happens the evening before. If no name is in the question, it is about you.

Task done ticks only your own tasks and those not yet assigned to anyone. If several tasks match, WuselWall asks instead of guessing. Without text, the shortcut lists what is still open.

Language

Answers come in the iPhone's language when it is German, English, French or Spanish, otherwise in the household's language. The field lang (de, en, fr or es) sets it.

Revoking a key

If a phone is lost, or someone no longer needs the shortcut, tap Revoke in the list. It takes effect at once: the shortcut then only answers that it is no longer valid. The list shows when a key was last used. When someone leaves the family, their keys are revoked automatically.

Guardians see and revoke every key of the family, everyone else their own. The data export lists each key with its name and date, but not the key itself.

AI assistants (MCP)

An AI assistant that speaks MCP (the Model Context Protocol, for example Claude) can look things up in WuselWall with a key of its own: "What's on this week?", "What's for dinner on Thursday?", "When does Olivia finish school tomorrow?". It can neither add, change nor delete anything.

When creating a key, choose AI assistant instead of Automation. Only adults get a key for an assistant. It appears in the list under AI assistants and is revoked like any other key.

What the assistant reads leaves your server

The assistant reads the whole family's week: appointments, who is away when, the children's timetables, tasks, points, meals, recipes and the shopping list. That data goes to the assistant's provider and is subject to its privacy terms. Decide together whether you want that.

The assistant finds these lookups: the week overview, appointments, tasks, the meal plan, the shopping list, points, recipes, the timetable and who is home. Every answer names people by their names.

Connecting: add an MCP server in the assistant with the address from WuselWall, for example https://api.example.org/functions/v1/mcp, and send the key as the header Authorization: Bearer wwa_…. In Claude Code:

claude mcp add --transport http wuselwall https://api.example.org/functions/v1/mcp \
  --header "Authorization: Bearer wwa_…"

Assistants that can only sign in with OAuth and allow no header of your own cannot connect yet. A sign-in with a consent page will come together with adding things through assistants.

Without an iPhone

A shortcut is an ordinary web request. Any app that can send a request with a header works the same way.