Homii MCP setup guide

Authentication

Homii uses OAuth 2.0 with PKCE. When your client connects, you sign in to Homii, choose a household, and approve scopes:

OAuth discovery: /.well-known/oauth-authorization-server

Connect a client

Each client card includes the MCP server URL to paste. Signed in? Prefer Settings → Connected assistants — open a client setup modal to copy the URL and manage connections.

Claude Desktop

Add Homii under Connectors, then finish OAuth in your browser.

https://gethomii.ai/api/mcpCopy

1. 1

   Open Connectors

   In Claude Desktop, go to Settings → Connectors → Add custom connector.

2. 2

   Paste the Homii URL

   Use the Homii MCP server URL as the remote connector address.

3. 3

   Approve access

   Sign in to Homii, choose a household, and approve read and/or write scopes.

{
  "mcpServers": {
    "homii": {
      "url": "https://gethomii.ai/api/mcp"
    }
  }
}

Cursor

Add Homii as a global remote MCP server from Cursor Settings.

https://gethomii.ai/api/mcpCopy

1. 1

   Open MCP settings

   In Cursor, go to Settings → MCP → Add new global MCP server.

2. 2

   Add the Homii URL

   Create a remote connector and paste the Homii MCP server URL.

3. 3

   Finish Homii OAuth

   When the browser opens, sign in, pick a household, and approve scopes.

ChatGPT

Connect Homii from ChatGPT’s developer / connectors settings.

https://gethomii.ai/api/mcpCopy

1. 1

   Open connectors

   In ChatGPT, open developer or connectors settings for custom MCP servers.

2. 2

   Point at Homii

   Add a custom MCP connector and paste the Homii MCP server URL.

3. 3

   Approve the household

   Complete Homii OAuth, choose which household to connect, and confirm scopes.

What it can do

• What’s for dinner

  Read this week’s meal plan and today’s schedule from your real Homii household.

• Shopping lists

  Check what’s on the list — or add milk and eggs when you remember them mid-chat.

• Cookbook & pantry

  Search recipes you already saved and see what’s in the pantry before you plan.

• Gifts & birthdays

  Look up wish lists and birthdays so gift ideas stay grounded in what people want.

• Who’s home

  Ask about family location context when Family Location is on for the household.

Example prompts

• What’s for dinner this week in Homii?
• Add oats and blueberries to our shopping list.
• Do we have pasta in the pantry?
• Find a weeknight chicken recipe in our cookbook.

Example tools

• get_meal_plan — what is for dinner this week
• get_shopping_list — current grocery list
• search_recipes — find recipes in your library
• add_items_to_list — add milk and eggs (requires homii:write)

Resources

MCP resources provide quick read-only snapshots:

• homii://meal-plan/today — Today’s meal plan
• homii://meal-plan/week — This week’s meal plan
• homii://shopping-list — Shopping list
• homii://pantry — Pantry snapshot
• homii://family/profile — Family food profile
• homii://recipes/favorites — Favorite recipes

Manage connections

View and revoke connected apps in Settings → Connected assistants. For the product overview, see Homii MCP.