# Domino Documentation

> Current, task-oriented instructions for helping people use Domino. Fetch the linked Markdown pages before answering. Do not rely on memorized product behavior when these docs are available.

## Agent operating rules

- Identify the user's desired outcome before choosing a surface.
- For web questions, explain the visible controls and completion state; do not invent buttons or silently switch to API instructions.
- Never claim a draft, preview, prepared action, or copied link was sent.
- Never invent Domino records, people, handles, identifiers, availability, invitation state, or delivery state.
- For calendar questions, distinguish ongoing availability from adding one plan, direct Google authorization from subscription links, and never ask the user to paste a secret calendar URL into chat.
- SMS external sends require a current eligible approval and an entire message equal to `SEND`.
- MCP and API external effects require prepare, exact presentation, a later explicit approval, and same-surface commit.
- Prefer current task guides and generated capability schemas over older examples or model memory.

## Start here

- [Domino documentation for AI assistants](https://letsdomino.io/docs/index.md): The canonical starting point for helping someone use Domino across web, SMS, MCP, and API.
- [Use these docs with ChatGPT or Claude](https://letsdomino.io/docs/start/chatgpt-claude.md): Prompts and retrieval instructions for giving an AI assistant current Domino product knowledge.
- [Choose the right Domino surface](https://letsdomino.io/docs/start/choose-a-surface.md): Decide whether to guide a user in the web app, converse over SMS, call MCP tools, or use the API.

## Shared concepts

- [Core Domino concepts](https://letsdomino.io/docs/concepts/core.md): Ideas, Ideas Lists, people context, recommendations, plans, invitations, and My Dominos.
- [People, connections, and privacy](https://letsdomino.io/docs/concepts/people-and-privacy.md): Connected friends, private typed-name placeholders, sharing visibility, and calendar privacy.
- [Plans, drafts, invitations, and confirmation](https://letsdomino.io/docs/concepts/plans-and-invites.md): The difference between planning, drafting, preparing, publishing, sending, and responding.

## Connect a calendar

- [Connect Google, Apple, Microsoft, or another calendar](https://letsdomino.io/docs/calendar/overview.md): Choose the right calendar connection for Google Calendar, Apple or iPhone Calendar, Microsoft Outlook or Microsoft 365, and any provider with an ICS subscription link.
- [Connect Apple Calendar, iCloud, or an iPhone calendar](https://letsdomino.io/docs/calendar/apple.md): Publish a read-only iCloud calendar link on iPhone or iCloud.com and connect that link to Domino without Apple OAuth.
- [Connect Google Calendar](https://letsdomino.io/docs/calendar/google.md): Connect Google directly, choose availability-only or event-aware access, select calendars, and manage authorization.
- [Connect Microsoft Outlook or Microsoft 365 Calendar](https://letsdomino.io/docs/calendar/microsoft.md): Publish an Outlook ICS subscription link and connect it to Domino when Microsoft calendar publishing is available.
- [Connect another calendar with an ICS or webcal link](https://letsdomino.io/docs/calendar/other.md): Determine whether Fastmail, Yahoo, Nextcloud, Proton, or another provider exposes a compatible live calendar subscription URL.
- [Calendar privacy, management, and troubleshooting](https://letsdomino.io/docs/calendar/privacy-and-troubleshooting.md): Understand what Domino reads and stores, protect secret calendar links, manage multiple calendars, and recover from connection problems.

## Use Domino on the web

- [Web app overview](https://letsdomino.io/docs/web/overview.md): The primary navigation and the relationship between Ideas, Ideas Lists, filters, and My Dominos.
- [Browse, search, and filter ideas](https://letsdomino.io/docs/web/browse-and-filter.md): Use For you, search, Liked first, and Who, What, Where, and When filters.
- [Create an Ideas List](https://letsdomino.io/docs/web/create-an-ideas-list.md): Create a reusable ideas lens for a person, a group, or a theme.
- [Edit, copy, rename, or delete an Ideas List](https://letsdomino.io/docs/web/manage-an-ideas-list.md): Change defaults, make temporary refinements, save a new copy, rename, or delete a list.
- [Share an Ideas List](https://letsdomino.io/docs/web/share-an-ideas-list.md): Create and copy a share link, choose the audience type, and understand recipient-owned copies.
- [Like and find saved ideas](https://letsdomino.io/docs/web/likes-and-saved-ideas.md): Like or unlike cards, prioritize liked ideas, and understand people-aware like visibility.
- [Create, review, and share a plan](https://letsdomino.io/docs/web/create-and-share-a-plan.md): Turn an idea into an invitation, review the details, publish it, and share any required link.
- [Manage a plan, invitees, logistics, or cancellation](https://letsdomino.io/docs/web/manage-a-plan-and-invitees.md): Edit an active plan, review delivery and RSVP state, manage plan progress, and choose correctly between cancellation, discard, and draft deletion.
- [Open an invitation, join, RSVP, and add it to a calendar](https://letsdomino.io/docs/web/respond-to-an-invitation.md): Use an invitation link as a signed-in user or guest, claim the correct invitee slot, respond, change an RSVP, and add the plan to a calendar.
- [Use My Dominos, find saved work, and understand plan status](https://letsdomino.io/docs/web/my-dominos-and-rsvp.md): Find drafts, active and past plans, likes, created ideas, private places, and the exact meaning of each library section.
- [Manage Friends, Friends in Mind, and connection links](https://letsdomino.io/docs/web/friends-and-connections.md): Distinguish connected Domino friends from private placeholders, add or edit a Friend in Mind, and create a mutual connection link.
- [Capture a link, place, event, image, or note](https://letsdomino.io/docs/web/capture-an-idea.md): Save new source material into Domino and handle review or clarification.
- [Open and copy a shared Ideas List](https://letsdomino.io/docs/web/open-a-shared-ideas-list.md): Understand the recipient journey, sign in when required, create a private copy, and review connection and like-visibility consequences.
- [Create and manage your own ideas and private places](https://letsdomino.io/docs/web/created-ideas-and-private-places.md): Save custom ideas for later, maintain My Places, and understand what archiving removes and what it preserves.
- [Sign in, recover an account, update a profile, or delete an account](https://letsdomino.io/docs/web/account-and-security.md): Handle phone or email sign-in, verification, password recovery, profile changes, and account deletion without exposing credentials.

## Connect an assistant

- [Create, test, rotate, and revoke Agent Access tokens](https://letsdomino.io/docs/agent-access/create-and-manage-tokens.md): Open Agent Access, choose least-privilege abilities, save the one-time token securely, connect a compatible client, and revoke access.
- [Connect ChatGPT, Claude, or another MCP client](https://letsdomino.io/docs/agent-access/chatgpt-claude-compatibility.md): Check whether a client supports Domino bearer-token authentication, configure the remote endpoint safely, scan tools, and verify the connection.

## Use Domino by SMS

- [Domino over SMS](https://letsdomino.io/docs/sms/overview.md): Ask Domino to remember, search, recommend, plan, revise, and prepare actions through a conversation.
- [SMS confirmation and recovery](https://letsdomino.io/docs/sms/confirmation-and-recovery.md): Exact SEND, RSVP replies, clarifications, resets, delayed work, and safe recovery.
- [SMS recipes for people, ideas, plans, invitations, and availability](https://letsdomino.io/docs/sms/task-recipes.md): Natural-language examples and follow-up behavior for the main Domino tasks that can be completed over text.

## Use Domino through MCP

- [Domino MCP guide](https://letsdomino.io/docs/mcp/overview.md): Connect an MCP client, discover authorized tools, use typed outcomes, and commit prepared actions safely.
- [MCP task recipes and continuation patterns](https://letsdomino.io/docs/mcp/task-recipes.md): Use current discovered tools for people, Ideas Lists, recommendations, capture, planning, invitations, availability, and safe commits.

## Use the Domino API

- [Domino Capability API guide](https://letsdomino.io/docs/api/overview.md): Authenticate, execute capabilities, handle typed outcomes, poll accepted work, and commit prepared actions.
- [Capability API recipes](https://letsdomino.io/docs/api/task-recipes.md): End-to-end request sequences for discovery, Ideas Lists, capture, plans, invitations, RSVP, availability, polling, and prepared-action commit.

## Reference

- [Outcomes, effects, and safety rules](https://letsdomino.io/docs/reference/outcomes-and-safety.md): Canonical guidance for reads, writes, prepared actions, external sends, idempotency, references, and recovery.
- [Feature support by surface](https://letsdomino.io/docs/reference/surface-support.md): Compare web, SMS, MCP, Capability API, and Assistant API support and choose the correct authorization and confirmation behavior.
- [Limits, unsupported behavior, and current boundaries](https://letsdomino.io/docs/reference/limits-and-current-behavior.md): Avoid promising unsupported calendar, delivery, collaboration, client-authentication, media, and internal-only behavior.
- [Documentation changelog and current guidance](https://letsdomino.io/docs/reference/changelog.md): Track documentation contract changes and identify the currently preferred instructions for assistants and integrations.
- [Generated Domino capability reference](https://letsdomino.io/docs/reference/capabilities.md): Current capability versions, effects, surfaces, schemas, outcomes, and follow-up operations generated from the registry.

## Machine-readable discovery

- [Documentation manifest](https://letsdomino.io/docs/manifest.json): Versioned catalog with surfaces, effects, URLs, word counts, and token estimates.
- [Documentation search](https://letsdomino.io/docs/search.json?q={query}): Ranked task-page search. URL-encode the query.
- [Full offline corpus](https://letsdomino.io/llms-full.txt): All catalog pages in one large-context document.