SellerSheet Documentation

Seamlessly synchronize Amazon Seller Central data with Google Sheets.

SellerSheet connects directly to Amazon's SP-API and Ads API, enabling automated data retrieval, analysis, and management within the familiar Google Sheets interface.

Dashboard Authorization

Use the SellerSheet Dashboard to securely authorize your Amazon Stores. This is where you connect your Seller Central account so SellerSheet can fetch your data.

Sidebar Installation

Install the SellerSheet Sidebar from the Workspace Marketplace. This adds the SellerSheet sidebar to your spreadsheets.

This documentation outlines the setup process, authentication workflows, and module-specific functionalities.

Sidebar Path

Open the sidebar in Google Sheets and click buttons to sync data. Best for daily operations — no coding required.

How the sidebar works →

AI Agents (MCP)

Connect Claude, Cursor, Coze, Codex, OpenClaw, or any MCP-compatible AI tool. Type in plain language — the agent handles multi-step tasks and writes results directly to your sheets.

Set up AI agents →

Prerequisites

  • Active Amazon Professional Seller Account
  • Google Account (Workspace or Personal)
  • Chrome Browser (Recommended)

Quick Start Guide

SellerSheet seamlessly synchronizes your Amazon Seller Central data with Google Sheets. Features include automated order syncing, comprehensive business reports, multi-store support, and simple team sharing.

1. Account Creation

Access the SellerSheet Portal to create your account.

  1. New Users: Click Continue with Google to create your account.
  2. Returning Users: Can also use Continue with Email to login via OTP.
  3. Use the same Google Account you use for Google Sheets.
  4. You will be redirected to the Dashboard upon success.
Login Screen

2. Store Authentication

2.1 Authorize Amazon Store

  1. Navigate to the Dashboard.
  2. Click the Add Store button.
  3. Enter a friendly Store Name (e.g., "MyStore").
  4. Select the Region. Important: Ensure the region matches your Amazon Seller Central account.
  5. Click Authorize Store to be redirected to Amazon for approval.

How your Store Name is used in sheets

SellerSheet identifies your store using a Store Identifier that combines your store name with the country code of your marketplace:

StoreName-CountryCode

For example, if you named your store "Bam-Bam-Shop" and selected Canada (CA), your store identifier is Bam-Bam-Shop-CA.

Sheets that connect to Amazon (such as Create Listings and Draft Listings) require you to type this identifier exactly into a designated cell (e.g. cell A2 or B1). If it doesn't match, you'll see a "Store not found" error. See how sheets use the store identifier →

[ Placeholder: Store name → sheet identifier diagram ]

Replace with: ./assets/images/guide/store-identifier-explainer.png

2.2 Authorize Advertising

  1. Once the store is listed, click Authorize Ads.
  2. Click Confirm to be redirected to Amazon Ads.
  3. Click Allow on the Amazon page.
  4. You will be redirected back. The ADS AUTH column will show the authorization date.

2.3 Team Access

  1. Click the Share button.
  2. Input the email address and click Share Store.
  3. Current Access lists existing users; Shared to confirms the new addition.
Add Store Dialog

3. Sidebar Installation

  1. Go to the Google Workspace Marketplace Listing.
  2. Click Install (or "Admin Install" for Workspace domains).
  3. Follow the prompts to grant permission to your Google Account.
  4. Open a new Google Sheet (or type sheet.new).
  5. Go to ExtensionsSellerSheetOpen Sidebar.
  6. The add-on will initialize and create the "SellerSheet" folder structure in your Drive.
Note: If you accidentally delete any folder or sheet, click Re-Initiate Resources (found under the My Resources section in the Home Tab) in the sidebar to restore the template.
Open Sidebar

4. Sync Orders

Verify your setup by retrieving your first batch of data.

  1. In the Sidebar, expand the Sales tab.
  2. Click the Sync Orders button.
  3. The Orders sheet in the "SellerSheet Sales" spreadsheet will populate with your recent 30 days of orders.
Sync Orders

Home Tab

The Home Tab is your central base in the sidebar. It hosts your essential tools and provides quick access to everything SellerSheet has created for you.

Documentation

Click this to open this guide. Useful for new users to get started quickly.

Pro Tip: Once you click this button, it will disappear from your Home menu to keep things clean. To re-open documentation later, click the icon at the bottom left of the sidebar.

Mini Dashboard

Your cockpit for account management. Opening the Mini Dashboard allows you to monitor:

  • Subscription: Check your current plan and expiry.
  • API Quotas: Real-time tracking of your SP-API and Ads API usage.
  • Stores: Secondary view of your owned and shared stores.
Sidebar Home Tab View

Home Tab Main Overview

My Resources

The My Resources panel in the Home tab shows everything SellerSheet has created for you — folders, spreadsheets, and connected stores. It's also your safety net: if anything goes missing, this is where you fix it.

What SellerSheet Creates

When you first open the sidebar, SellerSheet builds a SellerSheet folder in your Google Drive containing:

  • Folders: Organized storage for Invoices, Reports, Images, etc.
  • Spreadsheets: Pre-built templates for Sales, Catalog, Store Reports, FBA, A+, etc. Each spreadsheet contains multiple sheets (tabs) for sub-features.
  • My Stores: Stores you authorized on the SellerSheet Dashboard.
  • Shared With Me: Stores other team members have shared with you.

How SellerSheet Tracks Resources

SellerSheet remembers each folder and spreadsheet by its ID. If the resource still exists, SellerSheet keeps using it. If it's been deleted or can't be found, SellerSheet creates a new one and remembers the new ID going forward.

This means you can safely delete, rename, or reorganize — SellerSheet always adapts.

Recovery & Starting Fresh

My Resources doubles as a self-repair tool. Click any item's link or use Re-Initiate Resources at the bottom — SellerSheet checks every folder, spreadsheet, and sheet tab by name. If the exact name is missing, it creates a fresh template. Resources that already exist are left untouched.

  • Deleted something by accident?

    Click the missing item's name in My Resources, or click Re-Initiate Resources. SellerSheet creates a new resource and remembers it automatically.

  • Want a clean sheet template?

    Rename the existing sheet tab (e.g., InvoicesInvoices - Backup), then click Re-Initiate Resources. SellerSheet sees the original name as missing and creates a fresh template alongside your renamed copy.

  • Want to keep a full backup?

    Use File → Make a copy to duplicate the entire spreadsheet or folder first. Then clear the data in the original. SellerSheet continues using the original because the ID hasn't changed — your backup is safely separate.

Important

Recreated sheets are empty templates — your previous data is not restored. Always make a copy first if you need to preserve existing data.

Important Rule

You can only run actions for stores that appear in your "Store" column. Always ensure the sheet tab you are on matches the dropdown menu you use in the sidebar.
My Resources showing folders and spreadsheets with clickable links

Folders & Spreadsheets

My Resources showing connected stores and shared stores

Store Management

Sales

Sync orders, fees, refunds, and invoices from Amazon into your spreadsheet.

Orders sheet showing synced Amazon orders
Orders Sheet — Synced from Amazon
  1. Open the Sales spreadsheet from the sidebar Resources section.
  2. Navigate to the Orders sheet tab.
  3. In the sidebar, click Sync Orders — fetches all recent orders from Amazon and distributes them across Orders, Fees, and Refund sheets.
  4. For invoices, go to the Invoices sheet, fill in your store identifier, and click Get Invoices.

Store identifier: Each sheet that pulls Amazon data requires your store identifier in a designated cell (e.g. A2). Use the exact name shown in the sidebar — e.g. MyStore-AE.

Fees sheet
Fees Sheet
Refund sheet
Refund Sheet
Invoices sheet
Invoices Sheet

Advertising (PPC)

Manage Sponsored Products, Brands, and Display from dedicated sheets: SP Campaigns, SP Ad Groups, SP Keywords, SP Targets, SP Product Ads, SP Negatives, SP Camp Negatives, Portfolios, SB Campaigns, SD Campaigns. Every sheet follows the same pattern.

How every ads sheet works

  • Setup Sheet creates or resets the header block — filters in row 4, results from row 6. Hover any header for bilingual guidance.
  • List fetches entities using the row-4 filters. By default only active (enabled + paused) entities load — set State to ALL or ARCHIVED to see archived ones. Old rows are cleared on every refresh.
  • Create sends rows that have the required fields and an empty ID column; new Amazon IDs are written back into the row automatically.
  • Edit Selected / Archive Selected act only on rows whose Select checkbox (column A) is ticked — you can never mass-edit by accident. Archiving is permanent on Amazon.
  • Status column records the per-row outcome (SUCCESS / ERROR / ARCHIVED) of your last action.

Targeting expressions — bulk-sheet syntax

The SP Targets sheet reads and writes the same expression syntax as Amazon bulk files: close-match, loose-match, substitutes, complements, asin="B0XXXXXXXX", category="12345678", price<20, rating=4-5 — refinements combine on one line. No JSON required.

Inventory Management

Monitor stock levels across FBA and FBM fulfillment channels.

Catalogs

View live listings, check selling eligibility, draft new listings, and submit listing updates to Amazon.

Live Listings sheet showing current Amazon listings
Live Listings Sheet — Your active Amazon catalog
  1. Open the Catalogs spreadsheet from the sidebar Resources section.
  2. Go to the Live Listings sheet, enter your store identifier in A2, and click Sync Listings to pull your current catalog.
  3. To check selling eligibility for an ASIN, go to the Listing Restrictions sheet, enter the ASIN, and click Check Restrictions.
  4. To create or update listings in bulk, fill in the Draft Listings sheet and click Submit Listings. Monitor results in the Submission Log sheet.
Draft Listings sheet
Draft Listings
Listing Restrictions sheet
Listing Restrictions
Submission Log sheet
Submission Log

FBA Fulfillment

Create FBA shipments, generate box labels, and track shipment status — all from Google Sheets.

FBA Manage Shipments sheet
Manage Shipments Sheet — Create and track FBA shipments
  1. Maintain your warehouse address book in Shipment Setting and per-SKU box specs (Qty/Box, dimensions, weight, prep) in Product Info.
  2. Add a row in Manage Shipments (store, warehouse code, plan name, SKUs), click a cell in it and use Create STA SS — SellerSheet generates a dedicated STA spreadsheet for that plan.
  3. Run the numbered buttons in order. Box First (you know your boxes): Initiate Plan → Confirm Pack → Set Box Info → Gen Placement Opts. → pick a placement → Gen Trans. Opts. → pick carriers → Confirm Shipment. Split First (Amazon splits first): Initiate Plan → Confirm Placement (STA-Pack is generated) → fill boxes per shipment → Set Box Info → Gen Trans. Opts. → Gen Delivery Window (own-carrier only) → Confirm Shipment.
  4. Download FBA Box Labels and FNSKU Labels, then track progress with Sync Shipment Status on Manage Shipments.
  5. Browse historical plans (status, created / updated, ship-from) on the Search Inbound Plans sheet.

Tip: Ship Date must be today or later — Amazon silently returns no carrier options for past dates (SellerSheet now warns you first). Hover any header in the STA sheets for bilingual field guidance; gold headers are required, white optional, gray auto-filled.

Inventory Health Dashboard

A live, filterable view of every FBA SKU across all your stores — quantities, inbound pipeline, inventory age buckets, sell-through, weeks of cover, Amazon's recommended actions and estimated long-term storage fees, with product thumbnails. Sync FBA Data refreshes a hidden _raw_fba_data layer straight from the SellerSheet data warehouse (no Amazon API wait), and Setup Inventory Dashboard builds the Inventory Health tab: type into the filter row (store, SKU, ASIN, product name, min/max available, recommended action) and the =SQL() table re-queries instantly, with summary tiles recalculating above. Open the sidebar once in the FBA workbook to activate the SQL() function.

Shipment Setting sheet
Shipment Setting
Product Info sheet
Product Info
STA sheet
STA Sheet

B2B Shipments

Manage packing lists (PL) and carton labels for B2B or direct orders.

  • Upload Packing Lists via CSV
  • Generate FBA/AMZ Carton Labels
  • Track Shipment Status

A+ Content

Build, preview and publish A+ (Enhanced Brand Content) straight from the Create A+ sheet — one module per row, in display order.

  1. Fill the config row: store, locale (e.g. en-US), A+ name, content type (EBC standard / EMC premium) and optionally an image folder name.
  2. Pick a Module Type per row from row 5 down. The row's cell colors then show exactly what that module needs — green = required, yellow = optional, gray = unused.
  3. Add images by URL, or click Load Images (Drive) to place them automatically from your Drive folder (see naming below).
  4. Preview A+ renders the document locally before anything is sent.
  5. Enter the ASINs to attach, then Create & Submit — SellerSheet uploads every image to Amazon's media library, creates the document, applies the ASINs and submits for approval. Each step's result lands in the sheet.

Image file naming

Name files in your Drive folder <module>-<moduleSeq>-<imageSlot>[-anything].jpg and Load Images (Drive) places each one in exactly the right cell:

  • IMAGE_TEXT_OVERLAY-1-1.jpg → the 1st overlay module's image
  • three-image-text-1-2-left.png → 1st three-image module, image 2
  • FOUR_IMAGE_TEXT-2-3.jpg → 2nd four-image module, image 3

Important: Drive images must be shared "anyone with the link". Files that don't match the naming pattern are reported — never placed blindly. Hover the Image headers for each module's minimum pixel size (e.g. overlay 970×300, grids 300×300).

List A+ fetches every document in your store (details fill 25 rows per click); Manage A+ ASINs replaces the full ASIN set on an existing document and resubmits it for approval.

Store Reports

Request any of Amazon's 100+ SP-API reports on demand and download them directly to Google Drive.

Store Reports sheet showing report requests
Store Reports Sheet — Request and track Amazon reports
  1. Go to the Store Reports sheet. Enter your Store and the Report Name (copy from the Store Report Type sheet).
  2. Optionally set Data Start Time and Data End Time for date-range reports.
  3. Click Create Reports — SellerSheet submits the request to Amazon and fills in the Report ID.
  4. Wait for Amazon to process (usually 1–5 minutes), then click Get Reports. When ready, a clickable Sheet URL appears in the row.
ColumnRequired?What to put
StoreYesYour store identifier, e.g. MyStore-AE
Report NameYesExact name from the Store Report Type sheet
Data Start TimeOptionalStart date for reports that require a date range
Data End TimeOptionalEnd date for reports that require a date range

Report ID, Processing Status, Sheet URL, and Folder URL are filled in automatically. Find all available report names in the Store Report Type sheet.

Store Report Type sheet listing all available reports
Store Report Type Sheet — Reference for all available report names

System Settings

Configuration for global preferences and account management.

  • Workspace: Define Google Drive folder paths.
  • Subscription: Manage billing and plan tiers.
  • System Status: Check API connectivity health.

AI Agents (MCP)

Manage your Amazon business by talking to an AI — Claude, Cursor, Coze, Codex, OpenClaw, and more.

What is MCP?

Instead of clicking buttons in the sidebar, you connect an AI tool and describe what you want in plain language. The AI calls Amazon on your behalf, processes the data, and writes structured results directly into your Google Sheet — across multiple steps in one go. SellerSheet supports any MCP-compatible AI agent.

Example: "Pull my FBA inventory for SS-AE, find SKUs below 30 units, and write a reorder list to my Reorder sheet with current stock and days remaining." — One prompt. The AI calls Amazon, processes the data, and writes the sheet automatically.

Connect Your AI Tool

Add https://sellersheetai.com/mcp as a remote MCP server in your AI tool. The first time you run a SellerSheet command, a browser tab opens for one-click Google authorization — no API key to copy manually.

Claude Code

claude mcp add --transport http sellersheet https://sellersheetai.com/mcp Full setup guide →

Claude Desktop

Settings → Developer → Edit Config → add the MCP URL

Full setup guide →

Cursor

Settings → MCP → Add new global MCP server → paste the URL

Full setup guide →

Windsurf

Windsurf Settings → MCP → Add Server → paste the URL

Full setup guide →

Coze

Plugin → MCP Plugin → paste the URL and authorize

Full setup guide →

Codex & OpenClaw

Add https://sellersheetai.com/mcp as a remote MCP server in settings

Full setup guide →

What AI Can Do

DomainExample multi-step taskWrites to your sheet
Sales analysisCompare last 30 days vs previous 30 days by ASIN, flag declining productsDashboard sheet — ASIN, revenue, units, % change
InventoryFind all FBA SKUs below reorder threshold, estimate days of stock remainingReorder sheet — SKU, ASIN, current stock, days remaining
AdsPull all SP campaigns, calculate ACOS per campaign, flag anything above 30%Ads Analysis sheet — campaign, spend, sales, ACOS, flag
ListingsSync live listings, find any missing bullet points or fewer than 3 imagesFix Needed sheet — ASIN, title, missing fields
ReportsDownload last week's All Orders report, extract and rank revenue by ASINSales Summary sheet — top 10 ASINs by revenue

Example Prompts

Copy these prompts directly into your AI tool. Replace SS-AE with your store identifier.

Inventory reorder analysis

Check FBA inventory for SS-AE. Find all SKUs where stock is below 30 units.
Write them to the Reorder sheet with columns: SKU, ASIN, Current Stock, Days Remaining.

Writes to: Reorder sheet — SKU, ASIN, Current Stock, Days Remaining

Reorder sheet output showing SKUs below stock threshold

Sales comparison (30-day vs prior 30-day)

For SS-AE, compare sales for the last 30 days vs the 30 days before that.
Break it down by ASIN. Write a summary table to the Dashboard sheet
with columns: ASIN, Title, Last 30 Days Revenue, Previous 30 Days Revenue, Change %.

Writes to: Dashboard sheet — ASIN, Title, revenue comparison, % change

Dashboard sheet showing 30-day sales comparison by ASIN

Ads efficiency audit

Pull all active Sponsored Products campaigns for SS-AE.
Calculate ACOS for each campaign. Flag any campaign where ACOS is above 30%.
Write the full list to the Ads Analysis sheet sorted by ACOS descending.

Writes to: Ads Analysis sheet — Campaign, Spend, Sales, ACOS, Flag

Ads Analysis sheet showing campaigns flagged by ACOS

Listing health check

Sync live listings for SS-AE. Find any listings missing bullet points or with fewer than 3 images.
Write them to the Fix Needed sheet with columns: ASIN, Title, Missing Fields.

Writes to: Fix Needed sheet — ASIN, Title, Missing Fields

Fix Needed sheet showing listings with missing fields
WhatsApp WhatsApp