AI assistants
Connect HomeHero to Claude or ChatGPT and ask about your home in your own words: "where's the drill?", "put the tent and two sleeping bags in the garage loft", "what's due this month?". The assistant works on your real inventory, and it can only do what you allow when you connect it.
The connection uses the Model Context Protocol (MCP), an open standard that lets an assistant use another service's tools. You add HomeHero to your assistant once, sign in, and pick what it may do. After that you just talk to it.
Each section below has steps for you, and a short prompt you can paste into your assistant instead. The prompts point to the AI agent guide, which has the details an assistant needs.
What you need
- A HomeHero account with a verified email.
- A Sync or Premium plan. The assistant works on the copy of your inventory that Sync keeps on our servers. Connecting is free. Without a plan, the assistant can see your account but not your items, and it tells you so.
- An assistant that lets you add a custom connector (another name for an MCP server). Claude, ChatGPT, Claude Code and Codex do. Whether your assistant plan allows it is up to the assistant's maker.
- Your devices synced, so the assistant sees your latest changes.
HomeHero's address for assistants is https://api.homehero.pro/mcp.
Connect Claude
This works in Claude on the web, on desktop and on mobile.
- In Claude, open Settings → Connectors and choose Add custom connector.
- Name it HomeHero and paste
https://api.homehero.pro/mcpas the address. - Choose Connect. A HomeHero page opens. Sign in if it asks.
- HomeHero asks Allow Claude to use your HomeHero account? and lists what Claude would be able to do. Untick anything you don't want, then choose Allow.
- In a chat, turn HomeHero on from the tools menu if it isn't on already.
Assistants rename their settings from time to time. If you can't find Connectors, look for "custom connector" or "MCP" in the assistant's settings or help.
Connect ChatGPT
- In ChatGPT, open Settings → Apps & Connectors and choose Create. If you don't see it, turn on developer mode under Advanced settings first. Some ChatGPT plans and workspaces don't allow custom apps; ChatGPT's help says which do.
- Name it HomeHero, paste
https://api.homehero.pro/mcpas the MCP server URL, and choose OAuth for authentication. - Create it. A HomeHero page opens. Sign in, review the permissions and choose Allow.
- In a chat, add HomeHero from the tools menu.
Connect Claude Code or Codex
Coding agents that run in a terminal can add HomeHero themselves. You only approve the sign-in in your browser.
In Claude Code, run this, then type /mcp in Claude Code, pick
homehero and sign in:
claude mcp add --transport http homehero https://api.homehero.pro/mcp
In Codex, run these two commands. The second opens the sign-in page:
codex mcp add homehero --url https://api.homehero.pro/mcp
codex mcp login homehero
Check that it works
- Ask your assistant: "Which HomeHero account are you connected to, and what are you allowed to do?" It should name your account, list the permissions you allowed, and say whether your plan includes the inventory tools.
- Ask it to find something you know is there: "Where is my drill?"
- In HomeHero, open Settings → Connected apps. The assistant is listed, with when it was last used.
Things to ask
- "Where's the camping stove?"
- "What's in the garage loft?"
- "I put the tent, two sleeping bags and the stove in the garage loft. Add them."
- "Move everything tagged Camping to the shed."
- "The drill is cordless and 20 V. Update it."
- "What upkeep is overdue?"
- "Remind me to replace the furnace filter every 3 months."
- "I cleaned the gutters today. Mark it done."
The assistant says what it is about to change before it changes it. When a name matches more than one thing, it asks which one you mean.
What an assistant can and can't do
When you connect, you choose from four permissions. They're worded the same way in HomeHero:
| Permission | What it allows |
|---|---|
| See your items, locations, tags and item types | Search, look up an item, list locations and item types. |
| Add and change your items and locations | Add locations and items, edit an item, move items. |
| See your tasks and reminders | List tasks, including overdue and upcoming ones. |
| Add, change and complete your tasks | Add one-off or recurring tasks and mark them done. |
- An assistant can't delete anything. Delete things in the app yourself.
- An assistant can create locations but not rename or move them. Do that in the app.
- An assistant can't change your password, billing or account.
- It sees what has synced. A change still waiting on an offline device isn't visible yet.
- If something changed after the assistant read it, for example you edited the same item on your phone, the assistant's change is not written. The assistant reads it again and tells you.
- Reminders for tasks come from HomeHero, by email or in the app, not in the chat.
- Names, notes and field values in your inventory are treated as your data, never as instructions to the assistant.
See or disconnect connected apps
Open Settings → Connected apps in HomeHero while signed in. Each assistant shows its name, who publishes it when HomeHero can verify that, what you allowed, and when it was last used. Disconnect stops it working with your account straight away.
To change an assistant's permissions, disconnect it and connect it again. Changing your password or deleting your account disconnects every assistant.
Privacy
What the assistant reads from HomeHero goes to the company that runs the assistant (for example Anthropic for Claude or OpenAI for ChatGPT), under that company's terms. Only connect assistants you trust with your inventory.
HomeHero keeps a record of every change an assistant makes: which assistant, what it changed, and the values before and after. The record is kept for a year and erased if you delete your account. Changes you make yourself are not in it. If you want to know what an assistant changed, contact us.
Troubleshooting
- "Needs a Sync or Premium plan." Choose a plan in Settings → Account → Subscription, then ask again. You don't need to reconnect.
- It can't find something you just added. Open HomeHero on that device while online so it syncs, then ask again.
- "It changed since it was read." Someone or something edited it in the meantime. Ask the assistant to look again and redo the change.
- "Not given the permission." You unticked that permission when connecting. Disconnect and connect again, and leave it ticked.
- Sign-in doesn't finish. Verify your email first, check that the address is exactly
https://api.homehero.pro/mcp, and try again.
Frequently asked questions
Can I use HomeHero with Claude or ChatGPT?
Yes. Add HomeHero as a custom connector with the address https://api.homehero.pro/mcp, sign in and choose what the assistant may do. The assistant tools need a Sync or Premium plan, because they work on your synced inventory.
Can an AI assistant delete my items?
No. Assistants can search your inventory, create locations, add, edit and move items, and add and complete tasks, only with the permissions you allowed. They can't rename or move locations. Nothing can be deleted through an assistant, and it cannot change your password, billing or account.
How do I stop an assistant from using my HomeHero account?
Open Settings → Connected apps in HomeHero and choose Disconnect. It stops working straight away. Changing your password also disconnects every assistant.