Clover MCP (Model Context Protocol) Server

A minimal MCP server for interacting with the Clover API using OAuth authentication.

Overview

This MCP server allows generative AI models and other clients to access your Clover merchant data using the Model Context Protocol. With this integration, models can:

Retrieve merchant information
List inventory items
List orders
Access individual items and orders

Quick Start

Using with Claude AI (Recommended)

Add this to your Claude MCP settings (usually in ~/.config/anthropic/claude.mcp.json):

{
  "mcpServers": {
    "clover": {
      "command": "npx",
      "args": ["-y", "@ibraheem4/clover-mcp"],
      "env": {
        "CLOVER_CLIENT_ID": "your-clover-client-id",
        "CLOVER_CLIENT_SECRET": "your-clover-client-secret",
        "CLOVER_BASE_URL": "https://apisandbox.dev.clover.com"
      },
      "disabled": false,
      "autoApprove": ["initiate_oauth_flow", "get_merchant_info", "list_inventory", "list_orders"]
    }
  }
}

Use it with Claude:

/mcp use clover

Start the OAuth flow in your conversation with Claude:

Can you help me connect to my Clover account?

Using via Command Line

You can run the MCP server directly:

# Install and run in one command
npx @ibraheem4/clover-mcp

# With credentials
CLOVER_CLIENT_ID=your-client-id CLOVER_CLIENT_SECRET=your-client-secret npx @ibraheem4/clover-mcp

Clover OAuth Setup

Before using this MCP server, you need to set up a Clover app:

Create a Clover developer account at developer.clover.com
Register a new app in the Clover Developer Dashboard
Configure your app with:
- Site URL: http://localhost:4000/oauth-callback
- Default OAuth Response: Code
Note your Client ID and Client Secret
Add these credentials to your environment or .env file

MCP Tools

The following tools are available via the MCP protocol:

get_oauth_status: Check if OAuth credentials are available
initiate_oauth_flow: Start the OAuth flow to get access tokens
get_merchant_info: Get information about the merchant
list_inventory: List inventory items with optional filters
list_orders: List orders with optional filters

Example Usage with Claude

Here are some example prompts you can use with Claude after connecting:

Connect to Clover:
I'd like to connect to my Clover account.
Get Merchant Information:
What information do you have about my Clover merchant account?
List Inventory Items:
Show me the first 10 items in my inventory.
List Orders:
Can you list my most recent orders?

Development

Local Installation

Clone this repository
Install dependencies:
npm install
Set up your OAuth credentials:
cp .env.example .env # Edit .env with your Clover OAuth credentials
Build the TypeScript code:
npm run build
Start the MCP server:
./run.sh

Publishing Updates

To publish a new version to npm:

# Update version in package.json
npm version patch  # or minor, or major

# Build and publish
npm run build
npm publish

Troubleshooting

If you encounter OAuth problems:

Verify your Clover app is properly registered
Check that the Site URL in your app settings is set to http://localhost:4000/oauth-callback
Ensure your Client ID and Client Secret are correct
Make sure "Default OAuth Response" is set to "Code" in the developer dashboard
Try starting the OAuth flow again with initiate_oauth_flow

License

MIT

Clover MCP Server

Integrations