Log inSubmit server
Square MCP Server logo

Square MCP Server

Connect AI assistants to Square's APIs for payments, orders, catalog, customers, inventory, and other business services.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Square MCP Server

Pick your client, then add it in one click or paste the config.

Streamable HTTP (Remote)
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "square-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "square-mcp-server"
      ],
      "env": {
        "ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "SANDBOX": "YOUR_VALUE_HERE",
        "PRODUCTION": "YOUR_VALUE_HERE",
        "DISALLOW_WRITES": "YOUR_VALUE_HERE",
        "SQUARE_VERSION": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Hosted endpointLive · TodayLive Remote EndpointOur automated health check connected to this remote MCP endpoint successfully.Last checked 11/11/2026, 12:00:31 AM

Clients with native remote MCP support can connect directly to this URL.

Remote endpoint
https://mcp.squareup.com/mcp

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Square MCP Server is Square's beta MCP implementation for querying and calling the Square Connect API from AI assistants. It exposes tools for discovering service methods, inspecting parameter types, and executing API requests across Square services. Use Square's hosted endpoint with OAuth for the simplest setup, or run the local server with an access token when you need local execution, sandbox access, or configurable write restrictions.

Use cases

  • Query Square catalog items and inventory
  • Review payments, refunds, and disputes
  • Manage customer, order, and location data
  • Inspect Square API methods before making requests
  • Test Square workflows against the sandbox

Key features

  • Square Connect API access over MCP
  • Service method discovery
  • Request parameter inspection
  • API request execution
  • Hosted OAuth and local token-based modes
  • Sandbox and read-only configuration

Tools3

What Square MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~37 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars109Stargazers on the source repository.
Last commit27d agoMost recent push to the default branch.
Tools exposed3Callable tools this server registers over MCP.

How Square MCP Server works

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Square MCP Server

Square MCP Server is an MCP server that connects AI assistants to Square's Connect API. Its main tools discover service methods, inspect parameter requirements, and execute Square API requests. It covers services such as payments, orders, catalog, customers, inventory, refunds, subscriptions, bookings, and more through hosted or local deployment.

Run `npx square-mcp-server start` for a local installation, then provide `ACCESS_TOKEN` with a Square access token. You can also use Square's hosted MCP endpoint at `https://mcp.squareup.com/mcp`, which authenticates through OAuth instead of requiring a locally managed token.

Connect Claude Desktop by adding an MCP server entry that runs `npx mcp-remote https://mcp.squareup.com/mcp` for the hosted service. For local use, run `npx square-mcp-server start` and pass `ACCESS_TOKEN`, plus optional settings such as `SANDBOX`, in the configuration.

Yes, set `SANDBOX=true` when starting the local server to target Square's sandbox environment. A local command can use `ACCESS_TOKEN=... SANDBOX=true npx square-mcp-server start`, allowing requests to be tested without targeting the production environment.

Set `DISALLOW_WRITES=true` in the local server environment to restrict operations to read-only requests. This setting is useful when an AI assistant should inspect Square data without creating, changing, or deleting resources.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSquare MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/square-mcp-server?style=directory)](https://allmcps.com/mcp/square-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/square-mcp-server"><img src="https://allmcps.com/api/badge/square-mcp-server?style=directory" alt="Square MCP Server on AllMCPs" /></a>