Insights & Settings
AI & Agent Integrations
Connect trusted assistants to selected family lists with explicit read or write permissions, expiration, auditing, and instant revocation.
Best for
Every connection is bound to one family.
Read and write permissions are granted separately.
OAuth connections and scoped keys can be revoked immediately.
In this guide
Section 01
What a connected assistant can do
A trusted assistant can use Familiar as shared household context—for example, planning meals from the current shopping list, adding the missing ingredients, preparing chores, or creating a note. It only receives the tools permitted by the connection you create.
- Shopping read or write access.
- Chore read or create access.
- Note read or create access.
- No access to billing, passwords, invitations, or other families.
Section 02
Connect safely
- 1Open Integrations and select the active family.
- 2Name the assistant so you can recognize it later.
- 3Start with read-only scopes and add write access only when necessary.
- 4For ChatGPT, Claude, Cursor, or VS Code, copy the MCP URL and approve access in Familiar browser consent screen.
- 5For a developer client that cannot use OAuth, create a scoped key and store the one-time value in its secret manager.
- 6Revoke the connection immediately if a device, client, or credential is no longer trusted.
Treat the credential like a password
Familiar stores only a hash and cannot reveal the credential again. Do not paste it into chats, screenshots, or public configuration files.
Section 03
You remain in control
Every request rechecks that the connection is active, unexpired, still belongs to a current family member, and has the exact required scope. Tool use is recorded for operational auditing without storing the credential itself.
Section 04
How agents learn Familiar tools and data shape
Connected agents should call familiar_read_documentation before using household data. The response describes available domains, scope rules, core record shapes, safety expectations, and the canonical Markdown documentation URL.
The complete public product guide is also available at /docs/familiar.md. It contains no private household data and can be copied or saved from the Help Center.
- Shopping items include IDs, names, descriptions, quantity, priority, completion state, and planning fields.
- Chores include IDs, titles, assignments, difficulty, urgency, due state, and completion workflow.
- Notes include IDs, titles, content, sharing state, tags, reminders, comments, and attachments when enabled.
- Every private read or write remains bound to the approved family and Familiar scope.
- Useful starter workflows include meal planning, recurring restocks, turning shared notes into chores, and scheduled read-only list summaries.
Keep reading
These guides usually help next once you finish this one.
Shopping Lists
Plan shopping collaboratively, use optional prices and priorities, and understand totals, PDF export, and what belongs in the active list versus history.
Chores
Set up chores that people actually complete, follow progress across the workflow, and use stars and approvals without turning routines into noise.
Notes
Use shared notes for instructions, reminders, family knowledge, attachments, tags, comments, and share links when information needs to stay findable.
Settings & Billing
Manage profile details, family preferences, shopping currency, subscription choices, and account-level actions such as logout or deletion across the separate Settings and Billing pages.