The Square MCP Server provides a comprehensive interface for developers to interact with Square APIs to manage various business operations through a structured protocol:

• Payments: Process payments, refunds, handle disputes, and manage gift cards and bank accounts

• Terminal Operations: Manage Square Terminal devices, checkouts, and refunds

• Orders & Checkout: Create, retrieve, update, and manage orders and payment links

• Catalog Management: Handle catalog objects, images, modifiers, and taxes

• Inventory Control: Track inventory changes, counts, adjustments, and transfers

• Subscriptions: Manage subscription events, pausing, resuming, and plan changes

• Invoices: Create, update, cancel, and publish invoices

• Team Management: Handle team members, wages, labor shifts, and cash drawer operations

• Customer Management: Manage customer data, groups, segments, and custom attributes

• Loyalty Programs: Handle loyalty accounts, programs, points, events, and promotions

• Bookings: Manage bookings, team member profiles, and location settings

• Business Operations: Oversee merchants, locations, vendors, and sites

Note: This server version is deprecated; the latest version is available at square/square-mcp-server.

Provides access to Square API functionality through a Model Context Protocol (MCP) server

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Square MCP Server list my Square locations"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.

uv sync

# Required
export SQUARE_ACCESS_TOKEN=your_access_token_here

# Optional - defaults to 'sandbox' if not set
export SQUARE_ENVIRONMENT=sandbox # or 'production' for production environment

uv pip install .
square-mcp

source .venv/bin/activate
mcp dev src/square_mcp/server.py

Looking for Admin?