How to connect InVintory to Claude and other AI assistants (MCP)
Connect your collection to an AI assistant such as Claude, and ask it about your wine or let it add, update and remove bottles for you.
On each platform
Section titled “On each platform”Nothing to set up in the InVintory app. You connect from the assistant. The approval page opens in your browser, and anything the assistant adds or changes shows up in the app.
Nothing to set up in the InVintory app. You connect from the assistant. The approval page opens in your browser, and anything the assistant adds or changes shows up in the app.
The approval page opens on app.invintory.com. If you aren’t logged in there, you log in first. Then you see this:
An application is requesting access to your Invintory account. Review what it will be able to do, then allow or deny.
- •Read your wine collections and bottles
- •Add, update, and remove bottles in your collections
- •Search the global wine catalog
Connect in Claude
Section titled “Connect in Claude”- Open Settings → Connectors.
- Choose Add custom connector.
- Name it InVintory and paste
https://api.invintory.com/mcp. - Press Connect. A browser window opens on InVintory.
- Log in with your normal InVintory account.
- Read the permissions on Authorize access, then press Allow.
You never paste a password or a key into the assistant.
| Client | Where to add it |
|---|---|
| Claude: web, desktop and mobile | Settings → Connectors → Add custom connector |
| Claude Code | claude mcp add --transport http invintory https://api.invintory.com/mcp |
| Any other MCP client | Add a remote or custom server and paste the address |
What you’re approving
Section titled “What you’re approving”Authorize access lists what the assistant asks for. It says “An application is requesting access”, without naming the app, so check you started the connection yourself. The three permissions that reach your wine:
| Permission | What it lets the assistant do |
|---|---|
| Read your wine collections and bottles | Answer questions about what you own |
| Add, update, and remove bottles in your collections | Make changes for you |
| Search the global wine catalog | Look up wines you don’t own yet |
Your role in the collection still applies. If you’re a viewer, an assistant connected as you can read but can’t change anything.
What you can ask for
- Search and filter your collection by producer, region, grape, vintage, price, drink window, tags and more.
- Look up a wine in the catalog, with vintage guidance and critic scores.
- Add bottles, update details like price or drink window, and mark bottles as drunk, gifted or sold.
- Undo a removal, so a bottle marked as drunk by mistake comes back.
- Move bottles filed under the wrong wine to the right one.
- Set your own market value, fill in custom fields, and create tags.
- Rename a source, or merge two sources that are the same shop.
- Record a purchase, mark a delivery as delivered, and create a wine case.
- Add order and shipping details later: a purchase’s order number or notes, and a delivery’s expected date, tracking link or notes.
- Rename a wine case, set its size or delete it. Its bottles stay in your collection.
- Write, edit and delete your own reviews, and read them back.
- Report wrong details on a wine. Nothing changes until we’ve checked the report.
- Read a wine list you share and say what’s worth ordering.
- Read out a section of your 3D cellar slot by slot, and count the free slots.
- Place, move and take out bottles in 3D slots, or re-sort a rack by region, by vintage or in your own order. Ask it to undo if you don’t like the result.
If you have more than one collection
Section titled “If you have more than one collection”The assistant starts on your own collection. Ask it to list your collections and switch to the one you want.
- The choice is shared by every assistant and conversation connected to your account.
- After about an hour without use, it goes back to your own collection.
- Every change reports the collection it went to, so you can ask the assistant where it wrote.
Disconnect
Section titled “Disconnect”Remove the connector in the assistant. In Claude: Settings → Connectors → InVintory → Remove. InVintory has no list of connected apps, so if you can’t reach the assistant any more, contact support.
Changing or resetting your InVintory password disconnects every assistant. Connect each one again afterwards.
If it won’t connect
Section titled “If it won’t connect”| What you see | What it means | What to do |
|---|---|---|
| It says you need a subscription | The collection it’s working in is on the free plan | Upgrade it, or switch to a paid collection |
| It says permission denied | You’re a viewer and asked for a change, or a permission wasn’t approved | Ask for editor access, or remove the connector and add it again |
| Session expired on the approval page | Your login ran out before you pressed Allow | Tap Sign in, then start the connection again from the assistant |
| It says the cellar is busy | Another change to that cellar is running, in the app or another assistant | Wait a moment and ask again |
| It stops working | You changed or reset your InVintory password, or the connection couldn’t be renewed | Remove the connector and add it again |
Good to know
Section titled “Good to know”- Vincent is different. Vincent is built into the app and remembers your taste. An outside assistant gets the tools, not that memory.
- Both use the same collection. A bottle added by either shows up everywhere.

