What you'll need
- ✓Home Assistant 2026.2 or newer (includes the Model Context Protocol integration)
- ✓A reachable instance URL (Nabu Casa or an external URL) for the linking step
- ✓A Pantry Persona account
Generate your Home Assistant credential
Pantry Persona creates the Client ID and Secret that Home Assistant needs.
- Sign in at pantrypersona.com
- Go to Settings → Integrations → Home Assistant
- Leave it read-only (recommended), or tick "Allow changes" to let Home Assistant add to your shopping list and log cooked meals
- Click "Generate Home Assistant credential" and copy the Client ID and Secret
Tip: The secret is shown once, so copy it before you leave the page. Read-only covers everything voice-related; you can regenerate with write access later if you want it.
Add the credential in Home Assistant
Tell Home Assistant about the credential you just created.
- In Home Assistant, open Settings → Devices & Services
- Open the three-dot menu (top right) → Application Credentials
- Click "Add credential" and paste your Client ID and Client Secret
Add the Model Context Protocol integration
Connect Home Assistant to the Pantry Persona server.
- Settings → Devices & Services → Add Integration
- Search for "Model Context Protocol" and select it
- Paste the MCP Server URL below
- When prompted, choose the credential you added in step 2
MCP Server URL:
Link your account
Authorize Pantry Persona through the my.home-assistant.io page.
- A my.home-assistant.io page opens asking for your instance URL
- Enter YOUR reachable instance URL (your Nabu Casa or external URL, not the default homeassistant.local:8123 unless that actually resolves)
- Sign in to Pantry Persona and review what Home Assistant can access
- Click "Link account" to finish
Tip: The most common snag is the instance URL. If linking fails, it is almost always because the default local URL is not reachable from your browser.
Use it through your assistant
Pantry Persona is now available to your Home Assistant assistant.
- Ask your Home Assistant assistant about your kitchen, by chat or voice
- Or call it from an automation to announce expiring items in the morning
Tip: Home Assistant exposes Pantry Persona to its assistant, so anything your assistant can do (voice, dashboards, automations) can now reach your pantry.
Try these prompts to get started
Click any prompt to copy it
Read-only by default
The credential you generate can only read your kitchen unless you opt in to changes. You can regenerate with write access anytime.
MCP Server URL
Once connected, you can
- →Ask your assistant what’s expiring, by voice or chat
- →Announce expiring food in a morning automation
- →Ask what you can cook with what you have
- →Check your meal plan and shopping list hands-free