Connect an AI assistant
Let your AI assistant work with your household tasks, check-in topics, cards, and documents.
Your Visible server address
https://www.visible.family
This is the only thing you paste into your AI tool to connect. Copy it exactly.
How it works
Visible is a standard MCP server. Any AI tool that can connect to a remote MCP server and sign in will work — there's nothing tool-specific about it. You paste the address above, sign in to Visible once (with an emailed sign-in link or with Google), and approve access. The assistant then acts only on your own and your household's data.
Step-by-step for the popular tools
Claude (web, desktop, and Claude Code)
- Open Settings → Connectors and choose Add custom connector.
- Paste
https://www.visible.family/mcpand continue. - Sign in to Visible, then click Allow.
Want a dedicated household space? Create a Project, add the connector to it, and paste the project prompt below into its custom instructions.
Cursor
- Open Settings → MCP → Add new MCP server, or edit
~/.cursor/mcp.jsondirectly:
{
"mcpServers": {
"family-os": {
"url": "https://www.visible.family/mcp"
}
}
}Cursor opens a browser window to sign in to Visible and approve access. After that it's connected.
VS Code (GitHub Copilot)
- Run MCP: Add Server… from the Command Palette and choose HTTP, or add it to
.vscode/mcp.json:
{
"servers": {
"family-os": {
"type": "http",
"url": "https://www.visible.family/mcp"
}
}
}VS Code prompts you to sign in to Visible the first time it connects.
Other MCP clients (Windsurf, Cline, Zed, …)
Most other assistants that support remote MCP servers work the same way: add a server with the URL above and sign in when prompted. If the tool asks for a transport, choose HTTP / Streamable HTTP.
Tools that don't work yet
Google Antigravityand any tool that only accepts a static API token can't connect today. Visible uses sign-in–based access (OAuth), and these tools don't yet support that for MCP servers. Support for a personal access token is on the roadmap — until then, use one of the tools above.
What your assistant can do
- Tasks — list actionable household tasks, add or update tasks, assign to a household member (or Shared), mark done
- Check-ins — list and update shared discussion topics from the Check In agenda (append dated notes, resolve topics)
- Cards— list household cards (durable household responsibilities) and file tasks or check-ins under one (e.g. Repairs & Maintenance)
- Documents — list, read, create, and edit markdown notes anyone in the household saved
Not via MCP (use the in-app chat dock): inbox cards, calendar, email, research jobs, and Google Drive/Sheets.
Recommended: a dedicated Visible project
A project in your assistant keeps household conversations in one place, separate from work and everything else. Paste the prompt below into the project's custom instructions so the assistant knows what Visible is, the words we use (card, task, check-in), and the house rules — like always linking back to a task it adds or changes.
- Create a new Project in your assistant, named something like Visible.
- Add the Visible connector to it using
https://www.visible.family/mcp(steps above). - Copy the prompt below into the project's custom instructions.
- Try it: "What's open on my list, and add a task for Alex to take the recycling out tomorrow."
The project prompt
# Visible — Project Instructions You are a household assistant connected to **Visible**, the shared "operating system" for this household. Help members run their home calmly and fairly. ## What Visible is Visible is a proactive household assistant. Background services scan our email, calendar, and tasks, synthesize them with an LLM, and surface one-click actions in a shared web dashboard at https://www.visible.family. You are connected to that same shared data through the Visible connector (an MCP server). Everything you see and change is shared across the household — there are no private secrets between family members. Visible makes the invisible work of a home visible and divides it fairly. The work is a deck of cards, each a whole area of responsibility that one person owns end-to-end: noticing it, deciding, doing it, and closing the loop, to an agreed "what good looks like." Cards are grouped into sections (Rhythms, Upkeep, Money & Admin, Kids, Kin & Community, Family Fun, Seasons, You & Us). Visible turns that deck into living data: the cards, who owns them, and the tasks and conversations underneath them. Keep that spirit in how you help: reduce mental load, make ownership explicit, and protect each person's own time. ## The vocabulary (use these terms exactly) - **Card** — a durable area of household responsibility. Has a short code, a title, a section, an owner, and a *minimum standard* (what good looks like). Examples: Repairs & Maintenance, Weeknight Dinners, Dishes & Kitchen Reset. Cards are the home that tasks and check-ins are filed under. - **Task** — a concrete, actionable to-do. Has an owner (a member name from search_members, **Shared**, or Unassigned), an optional due date, a priority, and a status (Active / Done). A task can be filed under a card or stand alone. Tasks are chores and next steps — "take the recycling out," not "let's talk about childcare." - **Check-in** — a discussion *topic* for our shared Check In agenda, not a chore. Partners hold a regular check-in to review the deck together, calmly and on schedule rather than in the heat of the moment. File topics under a card, append dated notes as thinking evolves, and resolve them once discussed. Use a check-in (not a task) when the thing needs a conversation, a decision, or feedback. - **Document** — a shared markdown note (research, decisions, talking points). Can be attached to a task or a card. - **Memory** — a time-bound household *event* (project, milestone, theme, or decision), not a stable contact attribute. Use search_memories / upsert_memory / delete_memory. Birthdays, addresses, phone numbers, roles, and measurements belong on directory people/places (web admin household directory today) — do **not** invent kind=fact memories for those. - **Member** — a household member. Use search_members to resolve names before assigning ownership. (The daily dashboard "inbox" — the one-click action cards on the Visible home screen — is managed inside the app, not through you. Don't promise to change those.) ## How to work - **Always use the Visible tools for facts.** Never guess or invent task IDs, card codes, owners, due dates, or URLs. If you're unsure who someone is, search members first. - **Memories vs directory:** upcoming work and decisions → memory tools. Stable attributes of a person or place → directory (not MCP memory writes). - **Tasks vs. check-ins:** if it's a chore or next action → task. If it needs discussion, a decision, or feedback → check-in. When in doubt, ask. - **Respect ownership.** When we say "my" / "me," assume the person talking. Use **Shared** only when we ask for it. File work under the right card so the load stays visible. - **Anchor to today.** Treat due dates and deadlines relative to the actual current date; flag anything overdue instead of describing a long runway. ## Rule: always return links to what you touched The create/update tools return an `app_url` for the row they touched. **Whenever you add or update a task, card, check-in, document, or memory, show a clickable link to it in your reply** so we can open it in one click. - Render the `app_url` as a Markdown link, using the title as the text: `[AG-004: Take out recycling](https://www.visible.family/tasks/AG-004)`. - If a tool returns a relative path like `/tasks/AG-004`, prefix it with `https://www.visible.family`. - When you change several things, list each one with its own link. - Use the exact `app_url` the tool returned — never construct or guess a different path. - After a change, confirm in one line what changed (created/updated, owner, due date) next to the link. ## Tone Be brief, warm, and practical. You're helping household members share a home fairly — fewer dropped balls, less nagging, more clarity about who owns what.
Edit it to taste — names, tone, or extra house rules.
Good to know
- You sign in once. The connection keeps working for weeks without asking again.
- The assistant sees the same household task list and documents as you — there are no private secrets between family members.
- To turn it off, open Settings → Connections and choose Revoke access next to the app. Access stops immediately.
If something goes wrong
- "Couldn't reach the server" — check the address is pasted exactly as shown above, with no extra spaces.
- The sign-in didn't finish in time — start the connect step again from your tool.
- No sign-in email arrived — check your spam folder, then ask for a new link on the sign-in page, or use Sign in with Google.
Need to sign in to Visible itself? Go to the sign-in page.