Skip to content

How to connect InVintory to Claude and other AI assistants (MCP)

Paid plan Any AI assistant that supports 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.

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.

  1. Open Settings → Connectors.
  2. Choose Add custom connector.
  3. Name it InVintory and paste https://api.invintory.com/mcp.
  4. Press Connect. A browser window opens on InVintory.
  5. Log in with your normal InVintory account.
  6. 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

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.

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.

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.

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
  • 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.