clovercliCommand-line interface for managing Clover POS data including inventory, orders, payments, customers, employees, discounts, taxes, tenders, and reports with...
Install via ClawdBot CLI:
clawdbot install G9Pedro/clovercliCLI for Clover POS API — inventory, orders, payments, customers, employees, discounts, and analytics.
Version: 1.2.0 (90-day chunking, retry logic, period shortcuts, discounts, taxes, tenders)
# Install from npm
npm i -g @versatly/clovercli
# Or clone and build
cd ~/Projects
git clone https://github.com/Versatly/clovercli.git
cd clovercli && npm install && npm run build
# Set credentials (add to ~/.bashrc)
export CLOVER_ACCESS_TOKEN="your-token"
export CLOVER_MERCHANT_ID="your-merchant-id"
# Optional alias
alias clover='clovercli'# Check connection
clovercli auth status
clovercli merchant get
# Business dashboard
clovercli reports summary# Using --period (new in v1.2.0!)
clovercli reports sales --period today
clovercli reports sales --period yesterday
clovercli reports sales --period this-week
clovercli reports sales --period last-week
clovercli reports sales --period this-month
clovercli reports sales --period last-month
clovercli reports sales --period mtd # Month to date
clovercli reports sales --period ytd # Year to date
# Or use explicit dates
clovercli reports sales --from 2026-01-01 --to 2026-01-31
clovercli reports daily --period this-month
clovercli reports hourly --date 2026-02-03
clovercli reports top-items --limit 20
clovercli reports payments
clovercli reports refunds
clovercli reports taxes
clovercli reports categories
clovercli reports employees
clovercli reports compare --period1-from ... --period2-from ...
# Export data
clovercli reports export orders --output orders.csv --format csv
clovercli reports export items --output items.json# Merchant info
clovercli merchant get
# Tax rates
clovercli merchant taxes list
# Payment tenders
clovercli merchant tenders listclovercli discounts list
clovercli discounts get <id>
clovercli discounts create --name "10% Off" --percentage 10
clovercli discounts create --name "$5 Off" --amount 500
clovercli discounts delete <id>clovercli inventory items list
clovercli inventory items get <id>
clovercli inventory categories list
clovercli inventory stock listclovercli orders list --limit 50
clovercli orders get <id>
clovercli payments list --limit 50
clovercli payments get <id>clovercli customers list
clovercli customers get <id>
clovercli employees list
clovercli employees get <id>clovercli api get '/v3/merchants/{mId}/tax_rates'
clovercli api get '/v3/merchants/{mId}/modifiers'All list commands support:
--output table (default) — formatted table--output json — raw JSON--quiet — IDs only| Region | Use |
|--------|-----|
| us | US merchants (default) |
| eu | Europe |
| la | Latin America |
| sandbox | Development/testing |
Set via: export CLOVER_REGION=eu
| Client | Merchant ID | Notes |
|--------|-------------|-------|
| REMEMBR | 6KF70H0B6E041 | Mauricio's Brazilian restaurant (Pedro's dad) |
Generated Mar 1, 2026
A retail store manager uses CloverCLI to quickly generate daily sales reports with the '--period today' shortcut, monitor top-selling items, and export data to CSV for further analysis. This helps in tracking performance, managing inventory based on sales trends, and making data-driven decisions for restocking.
A restaurant owner utilizes CloverCLI to list inventory items, check stock levels, and create discounts like '10% Off' for promotions. They also run reports on employee sales and customer orders to optimize menu offerings and staff scheduling, improving operational efficiency.
A business operating in multiple regions (e.g., US and EU) sets the CLOVER_REGION variable to access region-specific data. They use CloverCLI to fetch tax rates, generate tax reports with period shortcuts like '--period this-month', and export JSON files for compliance and accounting purposes.
A developer sets CLOVER_REGION to 'sandbox' to test API integrations without affecting live data. They use raw API access commands to experiment with endpoints, create and delete discounts, and validate retry logic and chunking features for reliable deployment in production environments.
A small business owner runs summary reports and compares sales between periods (e.g., '--period last-week' vs '--period this-week') to assess growth. They also list payments and refunds, monitor customer data, and use the quiet output mode to quickly extract IDs for further processing in other tools.
This model involves offering CloverCLI as a tool for businesses to subscribe to automated reporting services. It generates revenue through monthly fees for access to advanced analytics, custom report generation, and integration support, targeting merchants who need ongoing insights without manual setup.
Businesses provide consulting services to help merchants set up and customize CloverCLI for their specific needs, such as configuring period shortcuts, managing discounts, and optimizing API usage. Revenue comes from one-time setup fees, hourly consulting rates, and ongoing maintenance contracts.
Companies license CloverCLI to rebrand and resell it as part of their own POS or business management software packages. This model generates revenue through licensing fees, customization charges, and upsells for additional features like enhanced reliability or region-specific support.
💬 Integration Tip
Set environment variables like CLOVER_ACCESS_TOKEN and CLOVER_MERCHANT_ID in your shell profile for seamless authentication, and use period shortcuts (e.g., '--period today') to simplify report generation without manual date calculations.
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
Command-line tool to manage Google Workspace services including Gmail, Calendar, Drive, Sheets, Docs, Slides, Contacts, Tasks, People, Groups, and Keep.
Runs shell commands inside a dedicated tmux session named claw, captures, and returns the output, with safety checks for destructive commands.
A modern text-based browser. Renders web pages in the terminal using headless Firefox.
Write robust, portable shell scripts. Use when parsing arguments, handling errors properly, writing POSIX-compatible scripts, managing temp files, running commands in parallel, managing background processes, or adding --help to scripts.
NotebookLM CLI wrapper via `node {baseDir}/scripts/notebooklm.mjs`. Use for auth, notebooks, chat, sources, notes, sharing, research, and artifact generation/download.