Clover POS MCP server
io.github.SBolivarLoL/clover-mcp·v0.7.0Clover POS for a single merchant: sales, inventory, orders, customers (reads + safe writes).
0 stars49 downloads/wk
Reviews
Write oneNobody has reviewed Clover POS yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Clover POS tools (47, 8 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_line_itemModifies merchant data. Add a catalog item as a line item to an order.
create_categorywrite actionModifies merchant data. Create a new inventory category.
create_customerwrite actionModifies merchant data. Create a new customer record in Clover.
create_itemwrite actionModifies merchant data. Create a new inventory item (name + price in cents).
create_orderwrite actionModifies merchant data. Create a new open order (no line items, no payment).
detect_sales_anomaliesAI: flag unusual refund / discount / sales patterns in a window (default: today).
draft_customer_messageAI: draft a customer message (promo / win-back / thank-you) for the given intent.
get_customerReturn a single customer by ID.
get_default_service_chargewrite actionReturn the merchant's default service charge configuration (name, enabled, percentage). Requires MERCHANT_R.
get_employeeReturn a single employee by ID (PINs never returned). Requires EMPLOYEES_R.
get_itemReturn a single inventory item by ID, including stock quantity. Requires INVENTORY_R.
get_merchant_infoReturn key information about this Clover merchant.
get_merchant_propertiesReturn the merchant's POS configuration (currency, tips, stock tracking, closeout, locale, support contacts). Banking/account fields are never returned. Requires MERCHANT_R.
get_orderwrite actionFetch a single order by ID, including line items and payment summary.
get_sales_summaryReturn an aggregated sales summary for the given date window.
get_top_itemsReturn the best-selling items in a date window, ranked by units sold.
inventory_reorder_suggestionsAI: prioritized reorder list — low-stock items crossed with sales velocity.
list_active_shiftsReturn currently open shifts (clocked in, not out) across all employees. Requires EMPLOYEES_R.
list_attributesReturn item attributes (variant axes like Size/Color) with options. Requires INVENTORY_R.
list_cash_eventsReturn recent cash-drawer events (paid in/out, no-sale, deposits).
list_categoriesReturn all inventory categories. Requires INVENTORY_R.
list_devicesReturn the merchant's Clover devices/terminals. Requires MERCHANT_R.
list_discountsReturn the merchant's discount catalogue (fixed-amount or percentage). Requires INVENTORY_R.
list_employeesReturn a page of employees (PINs never returned). Requires EMPLOYEES_R.
list_item_groupsReturn item groups (sets of item variants, e.g. size/color). Requires INVENTORY_R.
list_itemsReturn a page of inventory items. Filter by name (query) or category (category_id).
list_low_stock_itemsReturn all items whose stock quantity is at or below threshold.
list_modifiersReturn all modifier groups with their modifiers. Requires INVENTORY_R.
list_open_ordersReturn all currently open orders for this merchant (up to 200).
list_opening_hoursReturn the merchant's opening-hours sets (per-day time ranges). Requires MERCHANT_R.
list_order_typeswrite actionReturn the merchant's order types (Dine In, Take Out, …). Requires MERCHANT_R.
list_ordersList orders within an optional date window and/or state filter (default: today, limit 50).
list_paymentsList payments within an optional date window (default: today, limit 50).
list_refundsList refunds within an optional date window (default: today, limit 50).
list_rolesReturn the merchant's employee roles (name + system role category). Requires EMPLOYEES_R.
list_shiftsList shifts, optionally by employee and/or date window. Requires EMPLOYEES_R.
list_tagsReturn the merchant's tags/labels used to group items. Requires INVENTORY_R.
list_taxesReturn the merchant's tax rates (raw rate + computed percent). Requires INVENTORY_R.
list_tendersReturn the merchant's tender types (payment methods: cash, credit, custom). Requires MERCHANT_R.
list_tip_suggestionsReturn the merchant's tip-suggestion presets (percentage or flat amount). Requires MERCHANT_R.
search_customersSearch customers by full name (query), phone, or email.
set_item_price_centsModifies merchant data. Set an item's price (in cents, absolute value).
set_item_stock_quantityModifies merchant data. Set an item's stock to an ABSOLUTE quantity (not a delta).
suggest_item_categoriesAI: suggest categories for uncategorized items from the merchant's own taxonomy.
summarize_salesAI: plain-language sales briefing for a date window (default: today).
update_customerwrite actionModifies merchant data. Update a customer's name and/or marketing opt-in.
whoamiDiagnostic: who is this request authenticated as, and is a Clover tenant mapped to them?
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan26 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 3 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Clover POS compares
Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 77% of 2,174 E-commerce servers
- Tools
- 47
- the typical E-commerce server has 6
- Tools that change things
- 17%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 49
- more than 45% of 411 E-commerce servers with a package
What its tools let an agent do: 36 read · 5 create · 6 change
Install Clover POS in Claude Code, Cursor or VS Code
claude mcp add clover-mcp -- uvx clover-mcp
What the publisher says
From the Clover POS repository's README, as published. We do not edit it. Read it on GitHub
clover-mcp
MCP server for the Clover POS REST API — gives AI assistants (Claude, Cursor, etc.) read and safe-write access to a Clover merchant's sales, inventory, orders, and customers.
<!-- mcp-name: io.github.SBolivarLoL/clover-mcp -->
Status: v0.7.0 released; working tree (unreleased) — 56 tools, 6 prompts, both auth modes, 399 tests. Runs locally (stdio, single merchant) or remotely over HTTP with OAuth, single- or multi-tenant (see docs/DEPLOY.md). Endpoint contracts are sandbox-verified in docs/endpoints.md.
⚠️ Independent project — not affiliated with, endorsed by, or sponsored by Clover Network, LLC or Fiserv, Inc. "Clover" is a trademark of its respective owner and is used here only nominatively to describe interoperability. Provided as is, without warranty — see Legal & disclaimer.
What it can do
- Sales summaries, payment and refund reports
- Inventory lookups and low-stock alerts
- Order history and open-order inspection
- Customer search and creation
- Employee, shift, role, category, modifier, tax, tender, and device lookups; best-selling items
- Pricing config lookups: discount catalogue, tip-suggestion presets, default service charge
- Safe writes: update item prices, set stock quantities, create customers/items/categories/orders, add line items, update customers, rename items, apply order discounts, create modifier groups/modifiers/tags
- AI tools (reason via your client's model — the server holds no LLM key): sales briefings, reorder suggestions, anomaly detection, category suggestions, customer-message drafts
- Predefined prompt workflows: daily briefing, weekly sales report, inventory health check, end-of-day closeout, customer lookup, monthly tax summary
What it cannot do (by design): process refunds, capture payments, void charges, delete records. Those stay in the Clover dashboard.
Tools
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Clover POS: common questions
- Is Clover POS MCP server safe?
- Mostly: it is graded B (83/100). Read the Clover POS safety report
- How do I install Clover POS?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Clover POS need an API key?
- Yes. The registry entry asks for
CLOVER_ACCESS_TOKEN,CLOVER_REFRESH_TOKEN,CLOVER_OAUTH_CLIENT_SECRET. - Is Clover POS maintained?
- The last commit was 42 days ago (2026-09-23). The latest release is v0.7.0.
- What can I use instead of Clover POS?
- Servers from other publishers that do the same job: Shopify MCP server, Shopware MCP server and moysklad-mcp server.
- How does Clover POS compare with other E-commerce MCP servers?
- safety score 83/100 (higher than 77% of 2,174 E-commerce servers); tools 47 (the typical E-commerce server has 6); tools that change things 17% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Clover POS
Same job from other publishers: the closest match first, then the best rated.
- ShopifyMCP server for Shopify — Admin REST API (orders, products, customers, inventory, fulfillments)not reviewedGrowingB
- ShopwareQuery and safely manage a Shopware 6 shop: products, orders, customers, stock, audits, reports.not reviewedGrowingB
- moysklad-mcpMCP server for MoySklad — warehouse, inventory, orders, reports (Russia)not reviewedGrowingA
- StripeMCP server integrating with Stripe - tools for customers, products, payments, and more.not reviewedEstablishedA
- Polymarket ToolkitRead-only Polymarket data tools for AI agents: profiles, PnL, market scans. No keys, no orders.not reviewedEstablishedB