Shopify
Connect one Shopify store or many with a read-only app from Shopify's Dev Dashboard, so your AI can report on sales, orders, stock and customers.
Updated
Connect your Shopify stores and your AI can tell you how each one is doing: sales, orders, best sellers, stock at each location and customers. You create a small app for each store in Shopify's Dev Dashboard, give it read-only access, and paste its client ID and secret into Plugsight. Nothing goes through the Shopify App Store. Plugsight only reads: it can't change anything in your stores.
Each store is its own connection, so an agency or a business with several stores can connect all of them and ask about one, or compare them.
What your AI can do
- Sales report for any period, added up from all your orders in it: revenue, orders, items sold, average order, discounts, shipping, tax and refunds, day by day, plus the best-selling products. Only paid orders (paid, partially paid, partially refunded and refunded) count as revenue; pending, authorised-only, voided and expired payments, cancelled orders and test orders are listed separately.
- List orders, newest first, by status, payment status, fulfilment status, date range, customer email or any text.
- Read one order in full, by the order number customers see (for example #1001): items with their variant and SKU, what's still to ship, totals, discount codes, shipping, tax, refunds, tracking numbers, addresses, note and tags.
- Search products by title, SKU, vendor, type or status, with price, compare-at price and stock for each variant, or list variants whose stock is at or below a quantity you choose.
- Stock by location for one product: available, on hand, committed and incoming at each location.
- Search customers by name or email, with how many orders they've placed, how much they've spent and when they joined.
Example questions
- "Compare last month's sales across my Shopify stores."
- "Which products sold best this week, and which variants are running low on stock?"
- "How much of SKU TS-42 do we have at each location?"
- "Find order #1042 and tell me what was bought and where it's shipping."
- "Show every order from ann@example.com this year."
- "Compare Meta Ads spend last month with Shopify revenue for the same days."
What you need
- Any plan. Shopify isn't a marketing connector. Each store counts as one connection towards your plan's limit.
- For each store, a staff account in the organisation that owns the store with the App developer role (or, on Shopify Plus, a role with the Build and manage apps permission). The store owner can create the app, or give someone this role.
- Collaborator accounts, the kind agencies are often given, can't use Shopify's Dev Dashboard. Plugsight can only get access with an app made in the store's own organisation, so an agency can't make one app for all its clients' stores. For each client, either the client's staff creates the app and sends you its client ID and secret, or the client gives you a staff account with the App developer role.
- The store's myshopify.com address, like your-store.myshopify.com. Shopify shows it in your admin under Settings → Domains.
Connect a store
This takes about 5 minutes per store, in your Shopify admin and Shopify's Dev Dashboard. Repeat it for each store you want to connect.
1. Create an app in Shopify's Dev Dashboard
- In your Shopify admin, go to Settings → Apps and click Develop apps.
- In Shopify, click Build apps in Dev Dashboard. Starting from the store's own admin keeps the app in the organisation that owns the store, which Shopify requires. If you can't open the Dev Dashboard, ask the store owner for the App developer role (see What you need).
- In Shopify's Dev Dashboard, click Create app and choose Start from Dev Dashboard.
- Name it "Plugsight" and, in Shopify, click Create.
2. Give it read-only access
- In the app's version, add these access scopes: read_orders, read_all_orders, read_products, read_customers, read_inventory and read_locations.
- Release the version.
read_all_orders lets your AI see orders older than 60 days. Without it, Shopify only shares the last 60 days.
3. Turn on protected customer data
Shopify doesn't share customers' names, emails, addresses or phone numbers with a new app until you ask for them. Without this step, customer searches and order details can fail with a message telling you to turn it on.
- In Shopify's Dev Dashboard, open the app, click Settings and go to Access requests.
- In Shopify, find Protected customer data and click Manage.
- Select Customer data, give your reason (for example, "Reports on orders and customers for the store's owner") and, in Shopify, click Apply reasons.
- Select the Name, Email, Address and Phone fields, give your reason and, in Shopify, click Apply reasons.
- Fill in Shopify's Data protection details, then click Save in Shopify.
4. Install it on the store
- Open the app in Shopify's Dev Dashboard and click Install app.
- Choose your store and approve the access it asks for.
5. Paste the client ID and secret into Plugsight
- Open the app's settings in the Dev Dashboard. Its client ID and client secret are there.
- In Plugsight, open Connections, click Add connection and choose Shopify.
- Type the Store address, like your-store.myshopify.com. You can also paste the store's admin address.
- Optionally give the connection a Name, such as "Client: North Outfitters".
- Paste the Client ID and Client secret.
- Click Test connection & save. Plugsight checks the app's access with Shopify before saving anything.
When it works, you see a message like "Connected North Outfitters (north-outfitters.myshopify.com), id "…"." If the app is missing an access scope, the message says which.
Then add the connection to an MCP server. If this is your first store, refresh the tools list in your AI app and start a new chat.
Plugsight exchanges the client ID and secret for an Admin API access token that Shopify makes last about a day, and gets a new one when it runs out. Shopify only allows this for apps owned by the same organisation as the store, which is why the app is made from the store's own admin.
Already have a custom app with an access token?
Custom apps made in the Shopify admin before 2026 have an Admin API access token that starts with shpat_. Shopify no longer lets stores make new ones, but existing ones keep working.
- On the Shopify connect page in Plugsight, open Use an existing custom app's access token instead.
- Type the Store address and paste the Admin API access token.
- Click Test connection & save.
The app needs read access to orders, products, customers, inventory and locations.
Several stores
- Each store you connect is its own connection, named after the store. Connect as many as your plan allows.
- Connecting a store that's already connected replaces its credentials instead of adding it twice.
- When an MCP server has more than one store, name the store in your question ("for North Outfitters…"). Your AI passes the right connection to each tool.
What it can and can't change
Shopify is read-only in Plugsight. Your AI can't create, edit, fulfil, refund or cancel orders, or change products, prices, stock, customers, discounts or settings. The app only has read access scopes.
To cut access, uninstall the app from your store in Shopify, and remove the connection on Connections.
Limits
- A sales report reads up to 10,000 orders and stops asking Shopify for more after about 40 seconds. On a very busy store or a long period, or if Shopify stops answering part-way, it can stop early: your AI is told the totals are incomplete and how far they reach. Ask for a shorter period.
- Best-selling products count the first 10 different items of each order. Revenue and items sold always count every item.
- Sales report dates and order date filters use UTC.
- Order and customer lists return up to 100 at a time (25 by default), product lists up to 50. Your AI can ask for the next page.
- Sales reports list up to 50 best-selling products (10 by default).
- Without read_all_orders, only the last 60 days of orders can be read; a sales report reaching further back says it's incomplete.
- On Shopify's Basic plan, Shopify may hide customers' names, emails, addresses and phone numbers from custom apps, even with protected customer data turned on. Shopify keeps some of this access for stores on its Grow plan or higher.
- Stock by location lists up to 20 variants of a product, and up to 10 locations for each.
- Shopify limits how fast an app can ask for data. Plugsight waits and retries when it's asked to slow down.
Troubleshooting
Enter your store's myshopify.com address, like your-store.myshopify.com. Your Shopify admin shows it under Settings → Domains.
What it means: The address isn't a myshopify.com address. Plugsight only connects to stores by that address, never by a custom domain such as shop.example.com.
How to fix it: In your Shopify admin, open Settings → Domains and copy the address ending in .myshopify.com.
Shopify didn't accept this client ID and secret for …. Check you copied both from the app's settings in the Dev Dashboard, that the app is installed on this store, and that the store belongs to the same organisation as the app.
What it means: Shopify wouldn't give Plugsight an access token. The client ID or secret is wrong, the app isn't installed on this store, or the app was made outside the organisation that owns the store.
How to fix it: Copy both again from the app's settings. Check the app is installed on the store you typed. If it was made elsewhere, for example in an agency's own organisation, create it again starting from the store's own admin with a staff account of that store, as in step 1.
The app on … can't read orders. Add the read_orders access scope (and …) to the app, release a new version and update the app on the store, then try again.
What it means: The app doesn't have the read_orders access scope, which Plugsight needs.
How to fix it: Add the access scopes the message lists to the app's version, release it, approve the update on your store, then connect again.
The Plugsight app on … doesn't have the … access scope. Add it to the app's access scopes, release a new version, then update the app on the store (or reconnect).
What it means: Your AI asked for something the app can't read, such as customers without read_customers.
How to fix it: Add the access scope the message names, release a new version of the app and approve the update on your store.
The Plugsight app on … isn't allowed to read customers' details (…). In the Dev Dashboard, open the app, click Settings, go to Access requests and, under Protected customer data, turn on customer data and the name, email, address and phone fields. Then try again.
What it means: Shopify won't share customers' details with the app, because it hasn't been given access to protected customer data. The message names what Shopify held back, such as the email field.
How to fix it: Follow step 3, then ask again. On Shopify's Basic plan, Shopify may still hold back some customer details from custom apps.
Shopify rejected the app's client ID and secret; the app may have been uninstalled or its secret rotated. Reconnect the store on the Connections page in Plugsight.
What it means: The app was uninstalled from the store or its secret changed. The connection shows Reconnect needed.
How to fix it: Install the app again if needed, copy the current client ID and secret, and connect the store again.
Shopify rejected the Admin API access token; the app may have been uninstalled or the token revoked. Reconnect the store on the Connections page in Plugsight.
What it means: The custom app was uninstalled or its token no longer works. The connection shows Reconnect needed.
How to fix it: Create a Dev Dashboard app for the store and connect with its client ID and secret, as in Connect a store.
The Admin API access token starts with shpat_.
What it means: What you pasted isn't a custom app's Admin API access token.
How to fix it: Copy the whole token. If you have a client ID and secret instead, use the main form.
Shopify is limiting requests to … right now. Wait a minute, then try again.
What it means: The store's app hit Shopify's rate limit, even after Plugsight waited and retried.
How to fix it: Wait a minute and ask again, or ask for a shorter period or fewer results.