Clover MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Clover MCP or direct API to manage inventory, process payments, create orders, and update customer records through natural language.

Get started for free Get a demo

Clover

Oauth2

Clover is a point-of-sale and merchant platform that provides payments, orders, inventory, and device APIs. Use it to manage orders, customers, employees, payments, and receipts across locations.

208 Tools

Try Clover now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND

Clover

Enter ↵

Try asking

TOOLS

Supported Tools

Every Clover action and event your agent gets out of the box.

Apply Modification To Line Item

Applies a modifier to an order line item and snapshots the modifier's current name and price as a modification record.

Apply Order Service Charge

Applies a configured merchant service charge or creates an ad-hoc order-fee line item on an order.

Checkout Atomic Order

Calculates and previews an order cart, including totals, taxes, discounts, and service charges, without persisting an order.

Create Address For Customer

Adds a postal address to an existing customer record; it does not create the customer.

Create App Billing Metered Event

Records metered app usage and bills the merchant at the configured price; `count` defaults to 1.

Create Atomic Order

Creates an order with line items, modifiers, discounts, and service charges while Clover calculates inventory-based totals and taxes.

Create Attribute

Creates an inventory variant attribute within an item group, optionally with its initial options.

Create Authorization On Payment

Create an authorization for a payment.

Create Customer

Creates a customer record for the connected merchant with the supplied identity and contact details.

Create Customer Card

Creates a vaulted credit or debit card record for a customer.

Create Discount

Creates a merchant inventory discount with a fixed amount or percentage for later application.

Create Discount On Line Item

Applies a named fixed-amount or percentage discount to one order line item.

Create Discount On Order

Applies a named fixed-amount or percentage discount to an order subtotal, not a specific line item.

Create Email Address For Customer

Adds an email address to an existing customer record; it does not create the customer.

Create Employee

Creates a merchant employee profile with a required name and optional login, contact, and role details.

Create Inventory Item

Creates an inventory item.

Create Item Category

Creates an inventory category used to organize items in Clover Register.

Create Item Category Associations

Creates one or more associations between inventory items and categories or subcategories.

Create Item Group

Creates an item group for related inventory variants and their attributes.

Create Item Modifier Group Associations

Creates an association between an inventory item and a modifier group so the group's modifiers can be applied to that item.

Create Item Option Associations

Creates one or more associations between Clover options and inventory items.

Create Item Stock

Creates the stock quantity and optional low-stock alert threshold for one inventory item.

Create Item Tax Rate Associations

Creates one or more associations between inventory items and tax rates.

Create Merchant Opening Hours

Creates merchant opening hours.

Create Modifier

Creates a named modifier with a price adjustment inside a specific modifier group.

Create Modifier Group

Creates a new modifier group.

Create Multiple Inventory Items

Creates multiple inventory items in one request; use Update Inventory Items to patch existing items instead.

Create Notification For App

Send a message to devices that have the connected Clover app installed and are listening for notifications.

Create Notification For Device

Push a message to a device that has the connected Clover app installed and is listening for notifications.

Create Option

Creates a named option within an inventory attribute, such as `Small` for a `Size` attribute.

Create Order Line Item

Creates one line item for a standard or Multiple Service Charges order; provide `price` or `item.

Create Order Line Items Bulk

Creates up to 100 priced line items for either a standard or Multiple Service Charges order.

Create Order Type Category Associations

Creates associations that limit an order type to specific merchant categories.

Create Order Type For Merchant

Creates a custom order type for the merchant, such as dine-in, delivery, or takeout.

Create Payment Record On Order

Records an externally processed payment on an order for bookkeeping; it does not process a Clover credit or debit payment.

Create Phone Number For Customer

Adds a phone number to an existing customer record; it does not create the customer.

Create Role

Creates a merchant employee role based on a Clover system role.

Create Shift For Employee

Creates a time-clock shift for one employee, including clock-in/out times, cash tips, or override details.

Create Subcategory

Creates a subcategory within a parent inventory category; it inherits the parent's color when one is set.

Create Tag

Creates an inventory tag for reporting, with optional item and printer associations.

Create Tag Item Associations

Creates one or more associations between Clover tags and inventory items.

Create Tax Rate

Creates a merchant tax rate as a percentage or flat amount, optionally making it the default or associating items.

Create Tender

Creates a merchant-level custom tender and returns its generated identifier.

Delete All Line Items In Order

Deletes every line item from an order.

Delete App Billing Metered Event

Deletes an unbilled app metered event.

Delete Attribute

Deletes an inventory variant attribute.

Delete Authorization

Permanently delete a payment authorization.

Delete Categories

Permanently deletes the categories identified by a comma-separated list of category IDs.

Delete Customer

Deletes a customer from the connected merchant.

Delete Customer Address

Deletes one address from a customer.

Delete Customer Card

Deletes one vaulted card record from a customer.

Delete Customer Email Address

Deletes one email address from a customer.

Delete Customer Phone Number

Deletes one phone number from a customer.

Delete Employee

Deletes an employee from the connected merchant.

Delete Inventory Discount

Deletes a merchant inventory discount.

Delete Inventory Item

Deletes an inventory item.

Delete Item Category

Deletes an inventory category.

Delete Item Group

Deletes an inventory item group.

Delete Item Stock

Deletes the stock record for an inventory item.

Delete Line Item Discount

Removes a discount from an order line item.

Delete Merchant Opening Hours

Deletes one merchant opening-hours interval.

Delete Modifier

Deletes one modifier from a modifier group.

Delete Modifier Group

Deletes a modifier group and every modifier in it.

Delete Modifier Groups

Permanently deletes the modifier groups identified by a comma-separated list of IDs, including every modifier in those groups.

Delete Multiple Inventory Items

Permanently deletes the inventory items identified by a comma-separated list of item IDs.

Delete Option

Deletes an option from an inventory attribute.

Delete Order

Deletes an order.

Delete Order Discount

Removes a discount from an order.

Delete Order Line Item

Deletes a line item from an order.

Delete Order Type

Deletes a merchant order type.

Delete Role

Deletes a merchant employee role.

Delete Shift

Deletes one employee shift.

Delete Subcategory

Deletes a subcategory and reassigns its items to the parent category.

Delete Tag

Deletes an inventory tag.

Delete Tags

Permanently deletes the tags identified by a comma-separated list of tag IDs.

Delete Tax Rate

Deletes a merchant tax rate.

Delete Tender

Deletes a merchant tender.

Exchange Order Line Item

Creates a replacement line item under the client-supplied `line_item_id` and exchanges `old_line_item_id` for it.

Export Customers Csv

Exports customers as CSV.

Export Shifts CSV

Exports merchant shifts as CSV for a required effective clock-in time window.

Get App Billing Metered Event

Returns one metered billing event recorded for a merchant's app subscription.

Get Attribute

Returns one inventory variant attribute with the item-group and option references present in Clover's response.

Get Authorization

Retrieve one Clover payment authorization by identifier.

Get Category

Returns one inventory category, including its Register sort order and optional item expansion.

Get Configured Service Charge

Returns one service charge configured for the merchant, identified by `service_charge_id`.

Get Credit Refund

Retrieve one Clover credit refund, including its credit, order, device, employee, and transaction details.

Get Customer

Returns one customer profile, with addresses, email addresses, phone numbers, cards, or metadata when expanded.

Get Default Service Charge

Returns the merchant's default configured service charge.

Get Device Provisioned To Merchant

Returns one Clover device provisioned to the connected merchant.

Get Discount

Returns one merchant inventory discount, including its fixed amount or percentage.

Get Employee

Returns one merchant employee profile, with assigned roles or related shifts, payments, and orders when expanded.

Get Inventory Item

Returns one inventory item with pricing, availability, SKU, and requested related resources.

Get Item Group

Returns one inventory item group and its related variants or attributes when expanded.

Get Item Stock

Returns the current stock quantity and alert threshold for one inventory item.

Get Item Subcategory Associations

Returns an inventory item and, with `expand=categories.

Get Merchant

Returns the connected merchant's business profile and requested related resources.

Get Merchant Address

Returns the connected merchant's business address.

Get Merchant App Billing Information

Returns a merchant's app-billing status, including the current subscription tier and trial status.

Get Merchant Opening Hours

Returns one merchant opening-hours interval by identifier.

Get Merchant Payment Gateway Configuration

Returns the connected merchant's payment-gateway configuration and supported capabilities.

Get Merchant Properties

Returns the connected merchant's operational properties and feature settings.

Get Modifier

Returns one modifier from a specific modifier group, including its name and price adjustment.

Get Modifier Group

Returns one modifier group and its configuration, with related modifiers or items when expanded.

Get Option For Attribute

Returns one option from a specific inventory attribute, including its item references.

Get Order

Returns one order with totals, state, and any related resources requested through `expand`.

Get Order Line Item

Returns one line item from any order, including age-restriction or Multiple Service Charges fields when Clover provides them.

Get Order Type

Returns one merchant order type, including taxability and category-filter settings.

Get Payment

Retrieve one Clover payment, including amount, tax, tip, and result status.

Get Print Event

Get a print event for the connected Clover merchant by event ID.

Get Refund

Retrieve one Clover refund, including associated payment, tax, tip, and transaction details.

Get Role

Returns one merchant employee role and its base system role.

Get Service Charge Applied To Order

Returns one service-charge line item already applied to an order.

Get Shift

Retrieves one shift by ID.

Get Tag

Returns one inventory tag and its item or printer associations when expanded.

Get Tax Exemption Rule

Returns one tax exemption rule that links order types and items to excluded tax rates.

Get Tax Rate

Returns one merchant tax rate, including its rate, type, and default status.

Get Tender

Returns one merchant tender and its payment-handling settings.

Get Tip Suggestion

Returns one merchant tip suggestion, including its percentage or flat amount.

Get Voided Line Item Totals

Returns deleted line-item and order totals for a required caller-supplied deletedTime window.

List App Billing Metered Events

Lists billing events recorded for one app metered-event type, such as `reservation`.

List Attributes

Lists inventory variant attributes, such as size or color.

List Authorizations

List payment authorizations for the connected merchant.

List Cash Events

List cash events for the merchant, one device, or one employee.

List Categories

Lists inventory categories in Register sort order, optionally with associated items.

List Categories Of Item

Retrieves all categories of an item.

List Category Subcategories

Returns a category with its subcategories expanded by default; use `subCategories.

List Configured Service Charges

Lists service charges configured for the merchant; use the applied-service-charge tools for charges already attached to an order.

List Credit Refunds

List credit refunds for the connected merchant, including associated tax and transaction details.

List Customers

Lists customer records for the connected merchant, optionally filtered or expanded with related contact data.

List Devices Provisioned To Merchant

Lists Clover devices provisioned to the connected merchant, optionally filtered by documented device fields.

List Discounts

Lists the merchant's inventory discounts.

List Discounts For Order

Lists discounts currently applied at the order level; line-item discounts are returned by the line-item tools.

List Employee Orders

Lists one employee's orders through Clover's exact `/employees/{empId}/orders` route, which requires `Read employees`, while preserving a caller-supplied custom `filter`.

List Employees

List employees for the connected Clover merchant, optionally filtered or expanded.

List Inventory Items

Lists inventory items for the connected merchant.

List Inventory Without Revenue Class

Lists inventory items that have no revenue-class tag.

List Item Groups

Lists item groups used to organize related inventory variants and attributes.

List Items By Tax Rate

Lists inventory items associated with the specified tax rate.

List Items For Tag

Lists inventory items associated with one tag.

List Items In Category

Retrieves all items in a category.

List Items In Modifier Group

Retrieves a list of all items in a single modifier group.

List Item Stocks

Lists stock quantities and alert thresholds for the merchant's inventory items.

List Item Tags

Lists inventory tags associated with one item.

List Merchant Opening Hours

Lists the connected merchant's opening-hours intervals.

List Modifier Groups

Lists modifier groups that organize selectable item modifiers.

List Modifiers

Retrieves all modifiers from all modifier groups.

List Modifiers In Modifier Group

Retrieves a list of modifiers in a single modifier group.

List Options

Lists options across all inventory variant attributes.

List Options For Attribute

Retrieves all available variants or options associated with an attribute.

List Order Line Items

Lists line items from any order, including age-restriction or Multiple Service Charges fields when Clover provides them.

List Orders

Lists orders through Clover's merchant `/orders` route, which requires `Read orders`, with filtering, expansion, and offset pagination.

List Order Types

Lists merchant-defined order types and their system-type or category settings.

List Payments

List payments for the merchant, one order, or one employee.

List Refunds

List merchant refunds, including taxes and tips.

List Roles

Retrieves all system and employee roles for a merchant's business.

List Service Charges Applied To Order

Lists service-charge line items already applied to an order; use configured-service-charge tools for merchant templates.

List Shifts

List shifts for the connected merchant or, when `employee_id` is provided, for one employee.

List System Order Types

Lists Clover's system order-type categories used to classify merchant-defined order types, such as takeout.

List Tag Item Associations

Lists every association between the merchant's inventory tags and items.

List Tags

Lists the merchant's inventory tags.

List Tax Exemption Rules

Lists tax exemption rules that link order types and items to tax rates excluded from those items.

List Tax Rates

Lists percentage and flat-amount tax rates.

List Tenders

Retrieves all tenders for a merchant.

List Tip Suggestions

Retrieves all tip suggestions for a merchant, for example: flat tip or percentage.

Record Voided Line Items

Records voided line items on an order for reporting, including their quantities and reasons.

Remove Item Category Associations

Permanently removes specific item-category associations or all associations on one supplied side.

Remove Item Modifier Group Associations

Permanently removes a specific item-modifier-group association or all associations on one supplied side.

Remove Item Option Associations

Permanently removes specific option-item associations or all associations on one supplied side.

Remove Item Tax Rate Associations

Permanently removes specific item-tax-rate associations or all associations on one supplied side.

Remove Modification From Line Item

Removes an applied modifier snapshot from an order line item.

Remove Order Service Charge

Permanently removes a configured service charge or order-fee line item from an order.

Remove Tag Item Associations

Permanently removes specific tag-item associations or all associations on one supplied side.

Submit Print Request

Queues content for the merchant's default order printer.

Update Address For Customer

Updates one postal address on an existing customer record.

Update Attribute

Updates an inventory variant attribute, including its name, item group, or option references.

Update Authorization

Update a payment authorization.

Update Category

Updates an inventory category's name, Register sort order, color, or item associations.

Update Category Sort Orders

Updates Register menu sort positions for up to 1,000 inventory categories in one request.

Update Customer

Updates one customer's identity, contact, marketing, or metadata fields using the supplied values.

Update Customer Card

Updates a customer's vaulted credit or debit card record.

Update Discount

Updates a merchant inventory discount's name, fixed amount, percentage, or approval reference.

Update Email Address For Customer

Updates one email address on an existing customer record.

Update Employee

Updates one employee's name, login, contact, or role details using the supplied fields.

Update Inventory Item

Updates one inventory item's supplied fields.

Update Inventory Items

Patches multiple existing inventory items in one request without replacing omitted fields; use Create Multiple Inventory Items for new records.

Update Item Group

Updates an inventory item group's name, member items, or variant attributes.

Update Item Stock

Updates the stock quantity or low-stock alert threshold for one inventory item.

Update Merchant

Updates the connected merchant's business profile using the supplied fields.

Update Merchant Opening Hours

Updates one merchant opening-hours interval, including its day and start or end time.

Update Merchant Properties

Updates the connected merchant's operational properties and feature settings.

Update Modifier

Updates a modifier's name, price adjustment, or availability; Clover does not allow moving it to another modifier group.

Update Modifier Group

Updates a modifier group's name, selection rules, or item references.

Update Modifier Group Sort Orders

Update the priorities for a collection of up to 200 modifier groups at a time.

Update Option

Updates a named option within a specific inventory attribute, including its item associations.

Update Order

Updates one order using the supplied order fields; omitted fields remain unchanged.

Update Order Line Item

Updates one line item on either a standard or Multiple Service Charges order using the supplied fields.

Update Order Type

Updates a merchant order type's label, taxability, system classification, or category settings.

Update Payment

Update payment line-item allocations or the employee on an uncaptured preauthorization.

Update Phone Number For Customer

Updates one phone number on an existing customer record.

Update Role

Updates a merchant employee role's name, base system role, or employee references.

Update Shift

Updates one employee shift's clock-in/out times, cash tips, or override details.

Update Subcategory

Updates a subcategory's name or color within its parent inventory category.

Update Tag

Updates an inventory tag's name, reporting behavior, or item and printer associations.

Update Tax Rate

Updates a merchant tax rate's name, rate, type, or default status.

Update Tender

Updates a merchant tender's label, availability, cash-drawer, tipping, or processing settings.

Update Tip Suggestion

Updates a merchant tip suggestion's name, percentage, flat amount, or enabled status.

Upsert Customer Metadata

Creates or updates a customer's note, birthday, and business-name metadata.

Upsert Custom Order

Creates or updates a custom order for merchants with or without Multiple Service Charges.

SETUP GUIDE

Connect Clover MCP Tool with your Agent

Install Composio

typescript

npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai

Install the Composio SDK and your agent framework

Create a session with MCP enabled

typescript

import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["clover"],
  mcp: true,
});

Create a session scoped to Clover and read its MCP URL and headers

Connect your agent to the MCP server

typescript

import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List low-stock inventory items for restock",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();

Pass the session's MCP URL and headers to your agent and run a Clover request

SETUP GUIDE

Connect Clover API Tool with your Agent

Install Composio

typescript

npm install @composio/core @composio/openai openai

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK

Create a Composio session

typescript

import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["clover"] });
const tools = await session.tools();

Initialize Composio with the OpenAI Responses provider and create a session scoped to Clover

Run Clover tools with your agent

typescript

let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List low-stock inventory items for restock" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);

Send a request, execute the Clover tool calls through the session, and print the final answer

Why Use Composio?

AI Native Clover Integration

Supports both Clover MCP and direct API based integrations
Structured, LLM-friendly schemas for reliable tool execution
Rich coverage for reading, writing, and querying your Clover data

Managed Auth

Built-in OAuth handling with automatic token refresh and rotation
Central place to manage, scope, and revoke Clover access
Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

Tools are tuned using real error and success rates to improve reliability over time
Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

Fine-grained RBAC so you control which agents and users can access Clover
Scoped, least privilege access to Clover resources
Full audit trail of agent actions to support review and compliance

FRAMEWORKS

Use Clover with any AI Agent Framework

Choose a Framework you want to connect Clover with

ChatGPT

Use Clover MCP with ChatGPT

Claude Cowork

Use Clover MCP with Claude Cowork

Hermes

Use Clover MCP with Hermes

Atomic Agent

Use Clover MCP with Atomic Agent

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Addresszen

Api Key

Addresszen is a real-time address autocomplete and verification service. It helps capture accurate, deliverable addresses with instant suggestions and validation.

Asin data api

Api Key

Asin data api gives you detailed, real-time product data from Amazon, including price, rank, and reviews. Perfect for e-commerce pros and data-driven marketers who need instant marketplace insights.

Baselinker

Api Key

BaseLinker is an all-in-one e-commerce management platform connecting stores, marketplaces, carriers, and more. It streamlines order processing, inventory control, and automates your sales operations.

Bestbuy

Api Key

Best Buy is a leading retailer offering APIs for product, store, and recommendation data. Instantly access up-to-date retail insights for smarter shopping and decision-making.

FAQ

Frequently asked questions

Clover requires connections to go through your own OAuth app. You register it once with Clover, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to Clover as usual. Composio handles the rest of the flow and the token refresh.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Clover connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Clover account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Clover as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Clover lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Clover administrator may need to approve the app first, and you can revoke the access inside Clover whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Clover connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Clover tokens automatically, so day to day you do nothing. If you revoke access inside Clover, or Clover invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal Clover use. Paid plans add higher limits and team features. Your Clover plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Clover accounts).

With Composio, you connect Clover once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Clover.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Clover tool your agent needs.Free to start.

Start building

Clover MCP server for AI agents and assistants

Try Clover now

Supported Tools

Connect Clover MCP Tool with your Agent

Install Composio

Create a session with MCP enabled

Connect your agent to the MCP server

Connect Clover API Tool with your Agent

Install Composio

Create a Composio session

Run Clover tools with your agent

Why Use Composio?

AI Native Clover Integration

Managed Auth

Agent Optimized Design

Enterprise Grade Security

Use Clover with any AI Agent Framework

ChatGPT

Claude Cowork

Hermes

Atomic Agent

Rolling this out across your team?

Explore Other Toolkits

Addresszen

Asin data api

Baselinker

Bestbuy

Frequently asked questions

Do I need my own Clover developer credentials or OAuth app?+

Can I use multiple toolkits together?+

Is Composio secure with my Clover account?+

What if the API changes?+

Does the agent act as me inside Clover?+

Which Clover permissions does Composio get?+

Can I use multiple Clover accounts with Claude and ChatGPT?+

What happens when my Clover access expires or I revoke it?+

Does using Clover through Composio cost extra?+

How is Composio different from the Clover connectors already built into Claude and ChatGPT?+

Start with Clover.It takes 30 seconds.