Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"clover": {
"env": {
"CLOVER_REGION": "na",
"CLOVER_MERCHANT_ID": "your_merchant_id",
"CLOVER_ACCESS_TOKEN": "your_token"
},
"args": [
"clover-mcp"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
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.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'clover-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked clover-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in ecommerce
Argentine business automation: Mercado Pago, AFIP/ARCA, WhatsApp, banking, shipping (7 packages).
A command line tool for setting up commercetools MCP server
Rent GPUs, robots, drones, and construction gear on RIGShare; also onboards equipment owners.
MCP server for Chestniy ZNAK (Честный ЗНАК) API — product marking verification. No auth needed for
MCP Security Weekly
Get CVE alerts and security updates for io.github.SBolivarLoL/clover-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
Status: v0.6.0 — 47 tools, 6 prompts, both auth modes, 233 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 cannot do (by design): process refunds, capture payments, void charges, delete records. Those stay in the Clover dashboard.
| Tool | Kind | Notes |
|---|---|---|
get_merchant_info / get_merchant_properties | read | profile + POS config (banking fields never returned) |
get_sales_summary | read | aggregated window (see Sales summary semantics) |
list_payments / list_refunds / list_tenders | read | payments, refunds, tender types |
list_orders / get_order / list_open_orders / list_order_types | read | order history + detail |
list_items / get_item / list_low_stock_items | read | inventory + stock |
list_categories / list_modifiers / list_taxes / list_item_groups / list_attributes / list_tags / list_discounts | read | catalog structure |
list_tip_suggestions / get_default_service_charge | read | tip presets + service-charge config |
list_devices / list_opening_hours / list_cash_events | read | terminals, hours, cash-drawer log |
get_top_items | read | best-sellers by units in a window |
list_employees / get_employee / list_shifts / list_active_shifts / list_roles | read | PINs never returned (EMPLOYEES_R) |
search_customers / get_customer | read | cards never returned |
whoami | read | multi-tenant identity diagnostic (no secrets) |
summarize_sales / inventory_reorder_suggestions / detect_sales_anomalies / suggest_item_categories / draft_customer_message | AI | reason via your client's model; read-only suggestions |
create_customer / update_customer | write | dup-check + dry_run; update confirms via elicitation |
create_item / create_category / create_order / add_line_item | write | guarded: dry_run + confirm before writing |
set_item_price_cents / set_item_stock_quantity | write | optimistic-lock pre-check, bounds, dry_run |
Every tool carries MCP behaviour annotations (readOnlyHint / destructiveHint / idempotentHint) so clients can parallelize reads and prompt before writes.
uvx clover-mcp # coming soon after PyPI publish
Or from source:
git clone https://github.com/SBolivarLoL/clover-mcp-server
cd clover-mcp-server
uv pip install -e .