Skip to content

Connector review kit

Public details for reviewing, testing, and listing the Mavo MCP connector in ChatGPT, Claude, and other assistants.

Mavo exposes a remote MCP connector so approved assistants can work with the same household plan a family uses in Mavo.

Connector details

OAuth discovery

Most assistants discover these from the MCP URL:

  • Protected resource metadata: https://mavolife.com/.well-known/oauth-protected-resource
  • Authorization server metadata: https://mavolife.com/.well-known/oauth-authorization-server
  • Authorization URL: https://mavolife.com/api/auth/mcp/authorize
  • Token URL: https://mavolife.com/api/auth/mcp/token
  • Registration URL: https://mavolife.com/api/auth/mcp/register
  • Resource: https://mavolife.com/mcp

Default scopes:

  • openid
  • profile
  • email
  • offline_access
  • household:read
  • household:write

What the connector can do

Mavo tools are grouped into read and write actions.

  • Calendar: read events, create events, update events, remove events, manage external calendars, create or revoke share links, and show a read-only Family week view.
  • Collections: read and update household collections such as groceries, meals, books, routines, and custom lists.
  • People: list, add, update, or remove household person profiles.
  • Notifications: read recent notifications, send a notification, and manage notification preferences and routines.
  • Webhooks: list and manage outbound webhook destinations for household changes.
  • Checks and public lookups: check weather, search the web, read a public web page, and schedule a pre-event check.

If the signed-in user belongs to one family, Mavo uses it automatically. If the user belongs to more than one family, tool calls can name the family by slug so one connection can work across every family the signed-in user belongs to. The family slug is shown in Mavo under Settings -> Connected assistant.

Semantic context

Mavo's initialization response includes compact server instructions explaining that Mavo is a shared household plan, how plan items fit together, and why attendance is separate from responsibility. Those instructions also define Covered, Needs Attention, and No one needed so a client does not need to infer Mavo's product model from individual action names.

Clients can list and read the complete contents of Mavo's semantic product guides as text/markdown MCP resources:

  • mavo://guide/index
  • mavo://guide/overview
  • mavo://guide/shared-plan
  • mavo://guide/whos-handling-it
  • mavo://guide/add-from-anywhere
  • mavo://guide/notifications
  • mavo://guide/connect-your-assistant

The index says which guide matters for which kind of work. Tool descriptions reference only the relevant guide, while write-critical rules such as attendance-versus-responsibility, query-before-update, batch use, and recurring-event scope remain in the tool metadata and schemas.

MCP Apps

Mavo advertises the open io.modelcontextprotocol/ui extension and serves the versioned ui://mavo/family-week-v2.html resource as text/html;profile=mcp-app. The read-only showFamilyWeek tool points to that resource through _meta.ui.resourceUri and returns the same authoritative calendar result as both useful text and structuredContent, so clients without Apps support lose presentation but not capability.

The view is a self-contained HTML document with no external network access. It uses the standard MCP Apps ui/* bridge rather than a host-specific browser global, follows the host's theme and style variables, and requests a visible host border.

Data access

The connector is included on every Mavo plan. It acts as the signed-in Mavo user after that user approves the OAuth connection, and tool access is limited to families where that user is a member.

Read tools can return household plan data such as calendar events, collection items, people, notifications, webhook metadata, external calendar metadata, and context search results. Write tools can create, update, send, remove, or schedule household plan items depending on the tool used.

Mavo does not sell family information, does not show ads, and does not use family content to train Mavo's own AI models. See the privacy policy for the full provider and retention details.

Safety and revocation

Connected assistants are trusted with the access the user grants. Families can review changes in Mavo and disconnect the connector from the assistant's connector settings. Mavo's MCP metadata marks read-only tools separately from write tools, and marks destructive actions such as delete, revoke, and remove tools for client review.

Test prompts

  • "What is on our family calendar this week?"
  • "Show me our family week."
  • "Add soccer practice Thursday at 5 PM to the family calendar."
  • "What's on our grocery list?"
  • "Add milk, apples, and sandwich bread to groceries."
  • "Who is responsible for the dentist appointment?"
  • "Send a family notification that dinner is at 6:30."