Square

by Square

v0.1.2

APACHE-2.0

Repository Docs npm

Payments & Commerce

paymentssquareposcommerce

Summary

Square's official MCP server — manage catalog, orders, payments, customers, and inventory from an AI client.

Features

Access the full Square API through one server
Catalog, orders, payments, and customer management
Sandbox mode for safe development

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

Open your agent's MCP configuration file.
Merge the snippet below into it, filling in the environment variables with your own values.
Restart the agent — the "Square" tools will be available.

{
  "mcpServers": {
    "square": {
      "command": "npx",
      "args": [
        "-y",
        "square-mcp-server"
      ],
      "env": {
        "ACCESS_TOKEN": "your-square-token",
        "SANDBOX": "true"
      }
    }
  }
}

Claude Code

Add the server with a single CLI command.

claude mcp add square -e ACCESS_TOKEN=your-square-token -e SANDBOX=true -- npx -y square-mcp-server

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config).

{
  "mcpServers": {
    "square": {
      "command": "npx",
      "args": [
        "-y",
        "square-mcp-server"
      ],
      "env": {
        "ACCESS_TOKEN": "your-square-token",
        "SANDBOX": "true"
      }
    }
  }
}

Cursor

{
  "command": "npx",
  "args": [
    "-y",
    "square-mcp-server"
  ],
  "env": {
    "ACCESS_TOKEN": "your-square-token",
    "SANDBOX": "true"
  }
}

Windsurf

{
  "command": "npx",
  "args": [
    "-y",
    "square-mcp-server"
  ],
  "env": {
    "ACCESS_TOKEN": "your-square-token",
    "SANDBOX": "true"
  }
}

VS Code

{
  "command": "npx",
  "args": [
    "-y",
    "square-mcp-server"
  ],
  "env": {
    "ACCESS_TOKEN": "your-square-token",
    "SANDBOX": "true"
  }
}

Description

Square's official MCP server exposes the Square API to an assistant, covering the operations a merchant actually performs.

What it covers

Catalog — create and update items, variations, categories, and modifiers
Orders — create, search, and update orders
Payments — process and refund payments, and look up payment history
Customers — manage the customer directory and groups
Inventory — check and adjust stock counts
Locations, team, and bookings for multi-site businesses
Invoices and subscriptions

Where it saves real time

Bulk catalog work. Updating prices across a hundred items, restructuring categories, or importing a menu from a document are all tedious in a dashboard and straightforward when described in a sentence.

Sandbox first

The server supports a sandbox flag, and you should use it while working out what you want. Square handles real transactions and real inventory; an assistant that misunderstands a bulk update can do meaningful damage.

Runs with npx square-mcp-server, authenticated with an access token scoped to the permissions you need.

Related MCP Servers

Shopify Dev

by Shopify

Shopify's official developer MCP server — accurate API docs and schema introspection for building Shopify apps.

Payments & Commerce

shopifyecommercegraphql

PayPal

by PayPal

PayPal's official MCP server — create invoices, manage orders and subscriptions, and query transactions.

Payments & Commerce

paymentspaypalinvoicing

Browse all MCP servers →