Integrations
Supports loading Clover OAuth credentials from .env files for secure configuration of the MCP server.
Allows installation and running of the Clover MCP server via npx commands, making it easy to deploy and integrate with the Clover API.
Used for development of the MCP server, with build processes that compile TypeScript code before deployment.
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
Installing via Smithery
To install Clover MCP Server for Claude Desktop automatically via Smithery:
Using with Claude AI (Recommended)
- Add this to your Claude MCP settings (usually in
~/.config/anthropic/claude.mcp.json
):
- Use it with Claude:
- Start the OAuth flow in your conversation with Claude:
Using via Command Line
You can run the MCP server directly:
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
- Site URL:
- 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 availableinitiate_oauth_flow
: Start the OAuth flow to get access tokensget_merchant_info
: Get information about the merchantlist_inventory
: List inventory items with optional filterslist_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:Copy
- Get Merchant Information:Copy
- List Inventory Items:Copy
- List Orders:Copy
Development
Local Installation
- Clone this repository
- Install dependencies:Copy
- Set up your OAuth credentials:Copy
- Build the TypeScript code:Copy
- Start the MCP server:Copy
Publishing Updates
To publish a new version to npm:
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
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables AI agents to access and interact with Clover merchant data, inventory, and orders through a secure OAuth-authenticated MCP server.
- Overview
- Quick Start
- Clover OAuth Setup
- MCP Tools
- Example Usage with Claude
- Development
- Troubleshooting
- License
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityThis server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.Last updated -55TypeScriptMIT License
Fewsats MCP Serverofficial
AsecurityFlicenseAqualityAn MCP server that integrates with Fewsats allowing AI agents to securely purchase anything by retrieving balances, accessing payment methods, and processing payments.Last updated -411PythonArmor Crypto MCPofficial
AsecurityAlicenseAqualityAn MCP server providing unified access to blockchain operations, bridging, swapping, and crypto trading strategies for AI agents.Last updated -20193PythonGPL 3.0- AsecurityAlicenseAqualityAn MCP server that enables AI agents to authenticate with and interact with Open eClass platform instances, supporting UoA's SSO authentication system for retrieving course information and performing basic platform operations.Last updated -41PythonMIT License