# Square MCP Server [Official] [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/square/square-mcp-server  
**GitHub Stars:** 109  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/square-mcp-server

## Description
Square's official MCP server (beta). Lets AI assistants work with Square's Connect API: payments, orders, catalog, customers, inventory and more. Use the hosted server with OAuth sign-in, or run it locally with npx square-mcp-server start and an access token.

## Tools
Capabilities this server exposes over MCP:

- **get_service_info** — Discover methods available for a service
- **get_type_info** — Get detailed parameter requirements
- **make_api_request** — Execute API calls to Square

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "square-mcp-server": {
    "command": "npx",
    "args": ["-y","square-mcp-server"],
    "env": {
      "ACCESS_TOKEN": "",
      "SANDBOX": "",
      "PRODUCTION": "",
      "DISALLOW_WRITES": "",
      "SQUARE_VERSION": ""
    }
  }
}
```

**Requires environment variables:** `ACCESS_TOKEN`, `SANDBOX`, `PRODUCTION`, `DISALLOW_WRITES`, `SQUARE_VERSION` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Square MCP Server does

Square MCP Server connects MCP-compatible AI assistants to Square's Connect API. Through one MCP interface, an assistant can work with Square services including payments, orders, catalog, customers, inventory, refunds, invoices, subscriptions, bookings, locations, loyalty, team management, Terminal, and webhooks.

The repository contains Square's local, self-hosted implementation. Square also operates a hosted endpoint at `https://mcp.squareup.com/mcp`, which uses OAuth sign-in and is the recommended option for most users. The older `https://mcp.squareup.com/sse` endpoint remains available for existing SSE configurations.

## How it works

The server exposes three MCP tools:

- `get_service_info` lists methods available for a selected Square service.
- `get_type_info` returns parameter details for a selected service method.
- `make_api_request` sends an API request to Square.

A typical interaction first discovers the methods for a service, then checks the required request shape, and finally submits the API call. For example, an assistant can inspect the `catalog` service, retrieve the requirements for its `list` method, and call that method with `make_api_request`.

## Setup and configuration

For a local run, start the package with `npx square-mcp-server start` and provide a Square access token through `ACCESS_TOKEN`. `SANDBOX=true` selects Square's sandbox environment. `PRODUCTION=true` selects production, while `DISALLOW_WRITES=true` limits operations to read-only requests. `SQUARE_VERSION` selects the Square API version used by the server.

The hosted deployment avoids local token management by authenticating through Square OAuth. It can be connected to Claude Desktop with `mcp-remote` and the hosted URL. The repository also includes commands for installing the local server into Goose configuration or generating a Goose connection URL.

For local Claude Desktop configuration, register the `square-mcp-server start` command and pass the token and environment variables in the MCP server's `env` object. The package can also be started from a local project path.

## Tools and capabilities

Square's service catalog covers Apple Pay, bank accounts, bookings, cards, cash drawers, checkout, customers, disputes, gift cards, inventory, invoices, labor, locations, loyalty, merchants, orders, payments, payouts, refunds, sites, subscriptions, team, Terminal, vendors, and related custom-attribute and webhook services.

The server is generated from Square's OpenAPI specification. Developers can build or test the local project with npm, run its watch mode, and use the MCP Inspector against the built entry point.

## Limitations and notes

The project is marked beta. Local operation requires managing a Square access token, while the hosted service uses OAuth. Changes to generated code are expected to flow through the generator rather than being maintained only in generated files. Use `DISALLOW_WRITES` when an assistant should be restricted to read operations.

_Full upstream README: https://allmcps.com/mcp/square-mcp-server/readme_