SquareMCP Server

by Square

Added to Onei Jul 29, 2026

v0.1.2

APACHE-2.0

Repository Docs npm

Payments & Commerce

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

MCP: Adyen MCP Server

by Adyen

Adyen's official MCP server (alpha) — create checkout sessions and payment links, refund or cancel payments, and manage merchant accounts and terminals.

Payments & Commerce

MCP: PayPal

by PayPal

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

Payments & Commerce

MCP: Modern Treasury MCP Server

by Modern Treasury

Modern Treasury's official MCP server, built on Code Mode: the agent writes TypeScript against the payments SDK and runs it in a sandbox instead of calling one tool per endpoint.

Payments & Commerce

MCP: Binance

by Binance

Binance's official MCP server, part of Agent OS — spot and futures trading, live market data and account access, with per-agent permissions and funding limits.

Payments & Commerce

Browse all MCP servers →