Support

What do you need help with?

Start with the kind of help you need. Use recovery runbooks when something is stuck, and guides when you are learning or setting up a feature.

Last updated · 5 September 2026 For parents, partners & households
The short version

If you only read one paragraph.

Ūna protects your household content with encryption on your devices. If a phone is new or restored, Ūna may need to restore household access before it can show your private plans.

Support can look into sign-in, help with invites, and guide you through device recovery — but because everything is encrypted on your devices, we can't sign you in, restore access, or read content from our server.

Fix a problem

Recovery runbooks for stuck access, sync, invites, or device approval.

Recovery runbooks →
Use a feature

Guides for assistant setup, widgets, birthdays, imports, and more.

Guides →
Account & billing

Leaving, deletion, subscriptions, widgets, notifications, and support limits.

Account help →
Contact support

Write to us, or check what support can and cannot recover.

Contact →
Category · Recovery runbooks

Use runbooks when access needs restoring.

These are step-by-step recovery paths for a new phone, a device restoring access, device approval, sync trouble, or an adult joining. They are separate from normal feature guides because the stakes and next steps are different.

Tip · Set this up before you need it

Keep a second device signed in to Ūna as your backup.

A partner's phone, an old phone, or a tablet — any second device that already opens your household. If a phone ever shows “Restoring household access,” that trusted device can approve the new one in seconds, so you're never left waiting on support.

This matters most if you're the only adult in your household. With other adults, someone can always approve a new device or send you a fresh invite. On your own, a second signed-in device is your only safety net — without one, a lost or reset phone can mean losing access for good. It's the honest trade-off of an app this private: because only your devices hold the key to your household, only your devices can bring it back — there's no master copy for us to restore from, and that's by design.

Runbook · 01

If you see “Checking [your household]” on launch

On a returning device, Ūna first shows "Opening your planner" while it connects and loads your household. If the connection is slow and the server briefly reports no household, Ūna won't drop you onto a raw "Create / Join household" screen. Instead it shows a screen headed "Checking" followed by your household's name — for example "Checking Villa Dream Team" — with the note "Ūna is reconnecting before showing setup options" and a clear warning: "Do not create a duplicate household." It's a safety net: Ūna has local evidence you had a household, so it treats "no household" as suspicious first, not final. The usual cause is a weak or dropped connection during sign-in, not a household that's actually gone.

Ūna “Opening your planner” screen while it connects and loads the household
First: “Opening your planner” while Ūna connects.
Ūna “Checking your household” reconnect screen with a Try reconnecting button
Then, if needed: the reconnect safety net — tap “Try reconnecting.”
  1. 01 Don't start setup yet. If you had a household before, you almost certainly still do — this screen exists so you don't create a duplicate.
  2. 02 Check your connection. A weak or dropped signal during sign-in is the most common cause — move to better Wi-Fi or signal, or toggle airplane mode off and on.
  3. 03 Tap "Try reconnecting." It safely re-runs sign-in and household recovery; it never deletes, creates, or changes any household data.
  4. 04 Give it a moment and reconnect again if needed — many cases clear once the connection settles.
  5. 05 Still stuck? Fully close Ūna — swipe it away in the app switcher — then open it again. A fresh start often re-establishes the connection when reconnecting alone doesn't.
  6. 06 If you genuinely need to rejoin, tap "Join with invite" and use a fresh invite from another adult.
  7. 07 Only tap "Show setup options" if you truly are starting fresh. It's the deliberate escape hatch, shown after a warning.

Note Your encrypted household isn't gone just because one device can't reach it right now. If reconnecting keeps failing and you know your household should exist, it's safe to leave it on this screen and try again later on a better connection. If a device still can't get in, see Runbook 02 below.

Runbook · 02

Restoring household access

Ūna may show "Restoring household access." It means Ūna knows you're signed in, but this device still needs safe access to the household before it can show private content. Ūna won't show an empty home as if your household has no plans — you'll see a restoring, loading, or reconnecting state until it knows the real status.

  1. 01 Keep Ūna open on the device that says "Restoring household access."
  2. 02 Make sure you're signed in with the same Apple, Google, or Microsoft account you originally used for Ūna.
  3. 03 Ask another adult in the household to open Ūna on a device that already opens the household.
  4. 04 On that device, they go to Settings. If your device is waiting for approval, they'll see Device access with an "Approve new device" option.
  5. 05 After they approve, return to the restoring device — Ūna continues automatically.
  6. 06 If no approval appears but another adult still has access, ask them to send you a fresh invite.

Note Household content is private. A new or restored device can't read it until it has approved household access — and Ūna doesn't store decrypted plans on the server, so support can't turn server data into readable content.

Runbook · 03

Using Ūna on a new phone

Setting up Ūna on a phone you just got? Your sign-in restores your account, but the new device may still need approval before it can read your encrypted household.

  1. 01 Install Ūna.
  2. 02 Choose the same sign-in provider and account you originally used: Apple, Google, or Microsoft.
  3. 03 Keep Ūna open while it restores household access.
  4. 04 If another device already opens Ūna, approve the new phone from that device.
  5. 05 If another adult in the household has access, ask them to send a fresh invite from the Family tab.

Note On Apple devices, iCloud Keychain may restore the protected household key automatically. Android and cross-platform devices use approval from another trusted device or a fresh invite. Ūna can't restore the plaintext key from the server.

Runbook · 04

Approving a new device

When one of your own devices asks for access, a device that already opens Ūna may show "Approve new device."

  1. 01 Check the device name. Approve only devices you recognize.
  2. 02 Approve from the trusted device — it helps the new device regain household access.
  3. 03 If you don't recognize the device, don't approve it.

Note Ūna's server only relays protected device data during this hand-off. It never receives readable household content or a plaintext household key.

Runbook · 05

When a phone does not sync

If a phone is stuck restoring household access, work through these in order.

  1. 01 Confirm the person chose the same sign-in provider and account they originally used for Ūna: Apple, Google, or Microsoft.
  2. 02 Keep Ūna open for a moment.
  3. 03 Check whether another signed-in device can still open Ūna.
  4. 04 If yes, use that trusted device to approve the new phone.
  5. 05 If another adult still has access, ask them to send a fresh invite.

Note If nobody in the household has any trusted device or active adult access, encrypted household content can't be recovered. Support can check account status, invite status, and known service issues — but can't decrypt content or rebuild access from server data.

Runbook · 06

Inviting or re-inviting another adult

Adults and caregivers join with their own Apple, Google, or Microsoft account. After someone leaves, never reuse an old invite link — create a fresh one.

  1. 01 Open Ūna and go to the Family tab.
  2. 02 Tap "Invite another adult."
  3. 03 Create a fresh invite link.
  4. 04 Send it only to the person you want to join your household.

Note When re-inviting after someone left, a remaining adult may need to wait a short moment while household protection finishes updating. Ūna can briefly block invite creation while that's happening — this is expected.

Category · Guides

Learn or set up a feature.

Guides are for normal setup and feature use. The assistant setup guide is first because it has more context than the shorter everyday guides below.

Assistant setup Bring your own compatible assistant into selected Ūna calendar and list workflows through a scoped, provider-neutral MCP connection. Give it revocable access to specific people and lists — never broad household access.

Guide · Assistant setup

Connect your assistant to Ūna.

Plus Assistant access is included with Ūna Plus. If Plus ends, assistant calls pause. Existing connections remain visible so adults can manage or revoke them.

This is not a built-in Ūna assistant. Compatibility requires an external runtime that can store secrets securely, keep a private key, and run the Ūna SDK or equivalent trusted integration code.

Before you begin

  • An active Ūna Plus household and an adult account that can approve the connection.
  • A compatible assistant runtime that can keep secrets and run trusted code outside the model prompt.
  • Secure storage for the one-time bearer token and the P-256 private key.
  • A clear choice about where decrypted content will be processed: fully local or self-hosted, or by a hosted AI provider.

Choose an integration path

Recommended
TypeScript SDK

Install @unafamily/una-sdk in a Node 20+ trusted runtime for tested setup, key handling, encryption, decryption, and typed tools.

Protocol guide
Public SKILL.md

Give the public protocol skill to a compatible runtime that can implement HTTPS and WebCrypto safely without installing the package.

Local tools
Local MCP adapter

Run the optional adapter from GitHub when your assistant host prefers local una_* tools. The adapter decrypts inside its local process.

Advanced
Hosted protocol directly

Implement the provider-neutral encrypted endpoint directly in a trusted service that you operate or have deliberately chosen.

Assistant guide · 01

Capabilities say what it can do. Grants say what it can touch.

Keep these terms consistent when setting up or reviewing a connection.

Assistant connection

A separate external assistant identity connected to Ūna. It is not a household member.

Capabilities

The kinds of tools the assistant can use, such as calendar reads, event writes, or list updates.

Access grants

The specific people, lists, and calendar records the assistant is allowed to use.

Token

Shown once when creating or rotating the connection, then stored by the assistant runtime.

Public key

One half of the runtime’s P-256 setup key pair. Only the public key and stable Key ID are pasted into Ūna; the private key stays in trusted secret storage.

Agent-readable key

A separate content key wrapped to the connection’s public key. It protects approved assistant content without sharing the household key.

Agent-readable content

Content intentionally prepared for the assistant connection, instead of broad household access.

Assistant guide · 02

What assistants can do today.

Ūna does not choose meals, run shopping, or act as the general assistant. The external assistant can do that work outside Ūna, then write the agreed calendar events and list items into Ūna.

Read selected people profiles
Read selected calendar metadata
Read selected calendar details when granted
Find free time
Create calendar events
Update calendar events
Delete calendar events when explicitly scoped
Read granted lists
Create lists
Update list metadata and encrypted list names
Add list items
Add multiple list items in one batch
Update list items
Mark one item complete or incomplete
Mark multiple items complete or incomplete
Assistant guide · 03

Use presets as starting points.

Calendar helper

Find free time, create selected calendar events, and optionally read calendar details when granted.

List helper

Read selected lists, create or update lists, and add, update, or complete list items.

Calendar + lists

Combine calendar scheduling with selected list updates for packing, routines, groceries, or household coordination tasks.

Important Presets do not grant broad household access by themselves.

Assistant guide · 04

Set up the connection, then wire the runtime.

In Ūna
  1. 01 Open Ūna.
  2. 02 Go to Settings → Connections → AI Assistant.
  3. 03 Create a new assistant connection.
  4. 04 Choose the assistant label: ChatGPT, Claude, Hermes, or Custom.
  5. 05 Ask the compatible assistant runtime to create a P-256 setup key pair.
  6. 06 Paste its two-line “Public key:” and “Key ID:” reply into the pairing field. Version 1.3 extracts both values.
  7. 07 Choose a capability preset or select capabilities manually.
  8. 08 Grant access to specific people, lists, and calendar details or writes.
  9. 09 Review what the external assistant may receive, then approve the disclosure.
  10. 10 Copy the one-time token into the assistant runtime’s secure storage.
  11. 11 Test with a simple request.
  12. 12 Rotate or revoke access any time.
In the assistant runtime
  1. 01 Install with: npm install @unafamily/una-sdk
  2. 02 Configure https://mcp.unafamily.app/ and the one-time assistant token.
  3. 03 Register the matching private key in the agent runtime.
  4. 04 Call the setup helpers for manifest, context, and wrapped keys.
  5. 05 Decrypt only agent-readable returned records locally.
  6. 06 Encrypt write payloads locally before sending them to Ūna.
  7. 07 Use idempotency keys for writes.
Assistant guide · 05

Know where the privacy boundary moves.

Ūna’s backend remains unable to read household content. The privacy boundary changes when the trusted runtime decrypts approved records and decides whether to keep that plaintext local or send selected details to a hosted AI provider.

You control the plaintext path

Fully local or self-hosted

If the connector, model, logs, and storage all run on infrastructure you control—and the runtime does not forward readable details elsewhere—the selected plaintext can remain within that boundary.

The vendor can process selected plaintext

Hosted assistant or model API

If your runtime sends decrypted details to ChatGPT, Claude, or another hosted model—or the provider-hosted runtime decrypts them—the selected plaintext enters that provider’s environment and its policies apply.

Plain-language rule Encryption protects data in Ūna and in transit to the trusted runtime. Once approved details are decrypted, every service that receives that readable text becomes part of the privacy boundary.

  • Ūna never gives the assistant the household key. A separate agent-readable key protects only approved content.
  • The hosted MCP endpoint stores and returns encrypted household payloads; it does not decrypt household content.
  • Private keys, bearer tokens, encryption, and decryption stay inside trusted runtime code and secret storage — never in the model prompt. Plaintext should only be passed to the model when needed for the approved request.
  • Assistants only receive content that was intentionally made agent-readable and granted.
  • Capabilities decide what tools can run.
  • Access grants decide which people, lists, and calendar records are available.
  • Busy/free availability can remain visible without event titles, notes, locations, or URLs.
  • Treat returned household text and linked pages as untrusted data, never as instructions to reveal secrets or broaden access.
  • Ūna does not train AI models on household content. A fully local or self-hosted model can keep selected plaintext within infrastructure you control.
  • A self-hosted connector is not automatically a fully local assistant. If it calls a hosted model API, the selected plaintext sent in that request reaches that provider.
  • After approved plaintext reaches ChatGPT, Claude, or another hosted assistant or model provider, that provider’s storage, processing, retention, and training policies apply.
  • Adults can revoke access.
  • Ūna does not use assistant connections as household members.
  • Revoking stops future calls, but it cannot remove information already received by the external assistant.
Assistant guide · 06

Revoke for security. Delete from the list for cleanup.

Active

The household has Plus, the connection is active, and the current token is valid.

Paused by Plus status

If Plus ends, assistant calls pause. Existing connections remain visible so adults can review, revoke, rotate, or delete revoked entries.

Revoked

Future assistant calls are blocked and grants are removed.

Deleted from list

A revoked connection is removed from the visible list. Revoking is the security action; deleting from the list is cleanup after revocation.

Assistant guide · 07

Examples and troubleshooting.

Good requests
  • Find a time this week when everyone is free.
  • Create a calendar event for dinner on Friday.
  • Add these grocery items to the shared shopping list.
  • Create a packing list for the weekend.
  • Mark the completed grocery items as done.
  • Plan meals externally, then add the agreed events and shopping items to Ūna.
FAQ

Assistant cannot see a list

Check that the list was granted to the assistant connection.

Assistant cannot write

Check write capability and write access for the target calendar or list.

Assistant stopped working

Check Plus status, token rotation, or whether the connection was revoked.

Assistant sees less than expected

That is usually scoped access working as intended. Review the selected capabilities and access grants. Personal events stay private, and shared-event details stay busy-only if any assigned person is not covered.

Calendar result says unavailable

Unavailable is not an empty calendar. Check pairing, private-key loading, wrapped-key readiness, or whether eligible records need repair.

A long calendar request fails

The SDK limits event-list windows to 45 days per call. Split longer periods into consecutive windows, and use calendar.find_free_slots for person-specific availability.

Token lost

Rotate the token, then update the assistant runtime.

No Plus

Existing connections stay visible, but assistant calls pause while Plus is inactive.

SDK docs The package is published now; the optional local MCP adapter comes from GitHub. Read the npm package, GitHub repository, README.md, SKILL.md.
Guides · Short how-tos

Practical how-tos for normal days.

Short feature guides for the parts of Ūna households use often. These are not recovery runbooks; they are for setup, habits, and getting more out of the app.

Guide · 01

Using Notes as your household mini bank

Think of Notes as little accounts in a shared household bank — one note for each part of life you keep coming back to. A few that work well:

  • Recipes The meals your household actually cooks, with links — ready on the next grocery run.
  • Kids’ activities Rainy-day and weekend ideas, with links to bookings or how-tos.
  • Wish lists Birthday and holiday ideas everyone adds to through the year.
  • Travel checklist A packing list you reuse every trip. A to-do gets checked off and lost; a note stays whole — link it to the trip’s calendar event and it’s right there when you pack.
  • Christmas cards Who to send to, ticked off as you go.

Note Notes link to calendar events, lists, and people — so the right note surfaces exactly when you need it.

Guide · 02

Importing calendar events

Bring events from Apple Calendar or Google Calendar into Ūna. Imported events become encrypted household events — it’s a one-time import, not a live sync, so later changes in the source calendar won’t flow through.

Granting Ūna access to read your calendar for the import
Choosing a date range, calendar, and who the imported events are for
  1. 01 Open Settings → Import events.
  2. 02 Allow calendar access — Ūna reads it only while you choose what to import.
  3. 03 Pick a date range and calendar, choose who the events are for, then tap Import.

Note Imported events are copied in and encrypted as Ūna household events; afterwards they stand on their own and won’t stay in sync with Apple Calendar or Google Calendar.

Guide · 03

Tracking birthdays

Add a birthday once and Ūna remembers it every year — no shared spreadsheet, no one quietly forgetting. As you add it, you choose who sees it.

Adding a birthday in Ūna, with the who-can-see-it choice

Note “Only show for me” keeps a birthday private (handy for work contacts); “Share with household” reaches everyone for family and friends. Set a reminder — same day, a day before, or a week before.

Guide · 04

Using attachments

Attach the document a plan depends on right to its calendar event, so nobody’s digging through email at the gate.

  1. 01 Create the calendar event — a flight, a match, a reservation.
  2. 02 Add the PDF or image as an attachment.
  3. 03 Anyone in the household opens it straight from the event.

Note Great for flight itineraries, ticket PDFs, booking confirmations, and parking passes.

Guide · 05

Using location in calendar events

Add a place to an event and Ūna shows it on the event. Tap it to open straight in Apple Maps or Google Maps for directions — handy when you’re heading somewhere new.

Guide · 06

Setting up widgets

Put the day’s plan on your home screen so you see what’s next without opening the app.

Adding the Ūna Today widget from the home screen
  1. 01 On iPhone or iPad, open the home-screen editor, tap Add Widget, then search for Ūna.
  2. 02 On Android, touch and hold an empty area of the home screen, choose Widgets, then find Ūna.
  3. 03 Choose the widget you want and place it on your home screen.

Note Widgets are part of Ūna Plus. They read a small local snapshot on your device — they don’t need the app open and don’t start household sync on their own.

Guide · 07

Inviting another adult to the household

Ūna is at its best when the adults run the household together — both adding errands, plans, and birthdays. That shared effort is what gives a household its soul.

  1. 01 Open the Family tab.
  2. 02 Tap “Invite another adult.”
  3. 03 Create a fresh invite link.
  4. 04 Send it only to the person you want to join.

Note Re-inviting someone who left? Always create a fresh link — see Runbook 06 above.

Guide · 08

Plans, billing & restoring purchases

Ūna Plus unlocks widgets, assistant connections, Watch reminders, and richer household planning. Plans and billing live under Settings → Ūna Plus.

The Ūna Plus screen with plans, restore purchases, and manage subscription
  1. 01 Upgrade: open Settings → Ūna Plus and choose a monthly or yearly plan.
  2. 02 Paid but don’t see Plus? Tap Restore purchases to check the App Store or Google Play account used to subscribe.
  3. 03 Change or cancel: tap Manage subscription to open the settings for the store where you subscribed.

Note Billing is handled by Apple on iOS and Google on Android. Ūna can’t charge, refund, or cancel a subscription for you — manage it in the store where you subscribed.

Category · Account & billing

Membership, billing & your account.

No. 06

Leaving or being removed from a household

When an adult leaves or is removed, their household access is revoked and their devices should no longer read future household content. The household keeps running for everyone who remains.

  • Personal-only events, personal birthdays, personal reminders, device access, and the profile photo are removed from that household.
  • Shared household plans stay for the remaining household. Events and lists aren't deleted just because that person created them.
  • Ūna updates household protection in the background for the remaining adults.
  • If the person later rejoins, they use a fresh invite from a remaining adult — never an old link.
No. 07

Deleting your account

Deleting your account is different from leaving a household. Leaving removes your access to one household but keeps your Ūna account signed in, so you can create or join another. Deleting removes everything tied to this account.

  • Removes this account's household access and revokes its devices.
  • Removes personal and private data connected to the account.
  • Clears local household access and signs you out.
  • If you're the last adult in a household, deleting may also delete the household — Ūna asks for extra confirmation when that applies.

Note Ūna can't cancel an App Store or Google Play subscription for you. Manage or cancel it through the store where you subscribed.

Delete your account online →
No. 08

Billing when a paid adult leaves

If the person who pays for Plus, Premium, or Pro leaves a household, the subscription stays tied to the App Store or Google Play account used to purchase it.

  • Household benefits may stay active until the paid period ends.
  • After that, remaining adults may need to choose a new billing owner to keep paid household benefits.
  • Ūna can't manage or cancel an App Store or Google Play subscription for a user — the subscriber must manage it through the store where it was purchased.
No. 09

Widgets and notifications

Widgets use small local snapshots saved on your device. They don't connect directly to Ūna's sync backend and don't start household subscriptions.

  • Notification text is a local device feature. Reminder and birthday notifications may appear on your lock screen or notification center, depending on your iOS or Android settings.
  • You can manage widget and notification visibility in your device settings.
Category · Support boundaries

What support can and cannot recover.

Ūna support can help with
  • Looking into sign-in & account issues
  • Invite and re-invite steps
  • Device approval steps
  • Account deletion questions
  • Membership questions
  • Billing and subscription guidance
  • Bug reports and service status
Ūna support cannot
  • × Read your private calendar, notes, lists, birthdays, or locations
  • × Decrypt household content from the server
  • × Recreate household access if all trusted devices and active adult access are gone
  • × Cancel an App Store or Google Play subscription on your behalf

This is part of Ūna's privacy model. Your household content is meant to be readable by your household — not by Ūna support.

On sign-in “Looking into sign-in” means we can check your account status, invites, and known service issues to help explain what happened. Because your content is encrypted on your devices, we still can't sign you in or restore access ourselves — recovering a stuck device is done from another trusted device or a fresh invite, using the runbooks above.

Reach us

Still stuck? We'll help.

Support is available inside the app, under Settings, or you can write to us — we read every message. To cancel a subscription, manage it in the App Store or Google Play account where you subscribed; we can't do that for you.