The Flowhub MCP lets you connect your Flowhub data to an AI assistant so it can look things up and take action using plain language.
Flowhub MCP makes it quick and easy to manage your store through an AI assistant. In this article, we'll guide you through what the MCP can read, write, and do so your team can get answers and make updates without leaving the conversation.
The assistant can only call a fixed, permission-scoped set of tools. It has no free or raw database access. You don't need to learn commands, codes, or any special syntax. Talk to the assistant the way you'd talk to a coworker who knows your store. Ask for what you want, and it figures out the right action behind the scenes.
What can it read
All analytics (sales, inventory, customers, employees), the product catalog, live inventory, deals, pricing, fees, taxes, store and org configuration, and individual sales and receipts.
What it can write
Products and variants, inventory (including moving stock between rooms and batch price overrides), deals and promotions, tiered price profiles, and fees. Large changes can run through staged bulk edits (preview every row → confirm → apply).
What it CANNOT do
Ring up sales or run checkout, manage cash drawers, or check customers in. It also cannot create users or change permissions. Taxes, stores, rooms, categories, and store settings are read-only via MCP.
Watch the video below for a quick rundown of what the MCP server can do.
List of Available MCP Tools
Below are the actions an AI assistant can use once you connect Flowhub to Claude, ChatGPT, or Gemini. The assistant can only call this fixed, permission-scoped set. There is no raw database access, and each user's access always mirrors their existing Flowhub permissions.
The Access column tells you whether the assistant is looking something up (View), making a change you'll approve first (Update), or working with your account in the background (Setup).
Catalog & Products
Action | Access | Description |
View products | View | Browse your product catalog or pull up full details on one product. |
Add or edit products | Update | Create a new product (with variants and pricing) or update an existing one. |
Remove products or variants | Update | Delete a product, or remove a single variant from one. |
View brands & product types | View | List all the brands and product types in your catalog. |
Look up category rules | View | See which categories you can use and the fields a product needs before you add it. |
Inventory
Action | Access | Description |
View inventory | View | See your inventory batches, stock levels, SKUs, costs, and what's currently sellable. |
View suppliers | View | List your suppliers. |
Add or update batches | Update | Create a new inventory batch, or edit its stock, SKU, cost, or batch-level price. |
Move stock | Update | Move quantities between rooms (for example, back stock to the sales floor). |
Remove batches | Update | Delete an inventory batch. |
View rooms | View | See your inventory rooms and which are set as sales floor, quarantine, returns, or kiosk. |
Pricing, Fees & Taxes
Action | Access | Description |
View & build price profiles | Update | See your tiered, weight-based price profiles, or build a new one (e.g. $40 eighth, $75 quarter, $140 half). |
Edit or remove price profiles | Update | Update or delete an existing price profile. |
View & set fees | Update | See your fee rules, or add one — flat, percentage, or round-up — with cart thresholds. |
Understand your taxes | View | See your tax rates and how cumulative (stacking) taxes apply. |
Deals & Promotions
Action | Access | Description |
View deals | View | See all your deals and promotions, or pull up one in full. |
Create or edit deals | Update | Set up a promotion (product %, cart, buy/get, or bundle) or change an existing one. |
Remove deals | Update | Delete a deal. |
Check deal usage & fit | View | See how often a deal has been redeemed, or test which deals apply to a given cart. |
Analytics & Reporting
Action | Access | Description |
Sales analytics | View | Revenue, margin, discounts, taxes, and payment mix — by category, brand, store, or date. |
Inventory analytics | View | Inventory value, stock movement, and performance by category, brand, or location. |
Customer analytics | View | Customer counts, new vs. returning, spend, segments, loyalty, and trends. |
Employee analytics | View | Transactions, units sold, upsell rates, and captures per budtender. |
Custom reports | View | Combine any metrics and dimensions over a date range for a tailored report. |
Look up sales & receipts | View | Find individual sales by customer, payment method, order source, or date. |
Stores & Organization
Action | Access | Description |
View store setup | View | See your stores' hours, dual-license status, allowed customer types, and cart settings. |
View account setup | View | See your organization's configuration and which integrations are enabled. |
Large / Bulk Changes
When you want to change a lot of records at once, the assistant uses a safe, staged process: it stages the edit, shows you a preview of every affected row and any errors, and only applies it after you confirm. You can retry or cancel along the way.
Action | Access | Description |
Preview a bulk change | View | Stage a large edit and review every row it would affect before anything happens. |
Approve & apply a bulk change | Update | Confirm the previewed edit and run it as a tracked job. |
Manage a running change | Update | Track progress, retry rows that failed, or cancel a running job. |
Frequently Asked Questions
Does the MCP have access to my full database?
No. The assistant can only call a fixed set of permission-scoped tools. It has no raw or direct database access. Think of it like giving a coworker a specific set of keys rather than the master key to the building.
Will the assistant respect my Flowhub role permissions?
Yes. Each user's MCP access mirrors their existing Flowhub permissions. If your role cannot edit inventory in Flowhub, the assistant cannot edit inventory through MCP either.
Can the assistant ring up a sale or manage a cash drawer?
No. Checkout, cash drawer, and customer check-in workflows are not available through MCP. Those actions still happen directly in Flowhub.
What happens with bulk changes? Can the assistant make mistakes on a lot of records at once?
Bulk changes go through a staged process. The assistant first previews every affected row so you can review it before anything is applied. You approve, retry, or cancel at each step.
Great work! 🥳
Now you know everything the Flowhub MCP can (and cannot) do. Connect it to your preferred AI assistant and start managing your store in plain language.