✓ Verified 🛒 E-commerce ✓ Enhanced Data

Clovercli

CLI for Clover POS API — inventory, orders, payments, customers, employees, discounts, and analytics

Rating
4.7 (440 reviews)
Downloads
8,132 downloads
Version
1.0.0

Overview

CLI for Clover POS API — inventory, orders, payments, customers, employees, discounts, and analytics.

Complete Documentation

View Source →

CloverCLI Skill

CLI 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)

Setup

bash
# 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'

Quick Reference

bash
# Check connection
clovercli auth status
clovercli merchant get

# Business dashboard
clovercli reports summary

Reports with Period Shortcuts ✨

bash
# 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 Settings

bash
# Merchant info
clovercli merchant get

# Tax rates
clovercli merchant taxes list

# Payment tenders
clovercli merchant tenders list

Discounts (v1.2.0+)

bash
clovercli 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>

Inventory

bash
clovercli inventory items list
clovercli inventory items get <id>
clovercli inventory categories list
clovercli inventory stock list

Orders & Payments

bash
clovercli orders list --limit 50
clovercli orders get <id>

clovercli payments list --limit 50
clovercli payments get <id>

Customers & Employees

bash
clovercli customers list
clovercli customers get <id>

clovercli employees list
clovercli employees get <id>

Raw API Access

bash
clovercli api get '/v3/merchants/{mId}/tax_rates'
clovercli api get '/v3/merchants/{mId}/modifiers'

Output Formats

All list commands support:

  • --output table (default) — formatted table
  • --output json — raw JSON
  • --quiet — IDs only

Reliability Features (v1.2.0+)

  • 90-day auto-chunking: Long date ranges automatically split into chunks
  • Exponential backoff: Auto-retry on rate limits with backoff
  • Retry-after support: Respects Clover's retry-after header

Regions

RegionUse
usUS merchants (default)
euEurope
laLatin America
sandboxDevelopment/testing
Set via: export CLOVER_REGION=eu

Known Clients

ClientMerchant IDNotes
REMEMBR6KF70H0B6E041Mauricio's Brazilian restaurant (Pedro's dad)

Source

  • npm: https://www.npmjs.com/package/@versatly/clovercli
  • GitHub: https://github.com/Versatly/clovercli

Installation

Terminal bash 

openclaw install clovercli
Copied!

💻Code Examples

example.sh
# 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'
example.sh
# Check connection
clovercli auth status
clovercli merchant get

# Business dashboard
clovercli reports summary
example.sh
# 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
example.sh
# Merchant info
clovercli merchant get

# Tax rates
clovercli merchant taxes list

# Payment tenders
clovercli merchant tenders list
example.sh
clovercli 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>
example.sh
clovercli inventory items list
clovercli inventory items get <id>
clovercli inventory categories list
clovercli inventory stock list
example.sh
clovercli orders list --limit 50
clovercli orders get <id>

clovercli payments list --limit 50
clovercli payments get <id>
example.sh
clovercli customers list
clovercli customers get <id>

clovercli employees list
clovercli employees get <id>

Tags

#marketing_and-sales #api #cli

Quick Info

Category E-commerce
Model Claude 3.5
Complexity One-Click
Author g9pedro
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install clovercli

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0
✓ Verified 💻 Development

Adversarial Prompting

Adversarial analysis to critique, fix.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.6 (372)
↓ 28,222
v1.0.0