# Square MCP server (local)

The Square Model Context Protocol (MCP) server bridges AI assistants and the Square REST API.

MCP server by Square. Category: Agent craft.

## Install

Project (for this project only):

```sh
npx add-mcp square-mcp-server --args start --env 'ACCESS_TOKEN=${ACCESS_TOKEN}'
```

Works with: Claude Code, Codex CLI, Cursor, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx add-mcp square-mcp-server --args start --env 'ACCESS_TOKEN=${ACCESS_TOKEN}' -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Where it runs

Your computer.

## What it needs

Environment variables:

- `ACCESS_TOKEN` (required): Square API access token
- `SANDBOX` (optional): Use the sandbox environment
- `PRODUCTION` (optional): Use the production environment
- `DISALLOW_WRITES` (optional): Restrict to read-only operations
- `SQUARE_VERSION` (optional): Specify the Square API version

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.
- Needs a key or account: It asks for an API key or a sign in before it works.

## Source

[Open the source](https://developer.squareup.com/docs/mcp). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

- Previous: [Spaces](https://syn4pse.dev/terminal/spaces.md)
- Next: [Square MCP server (remote)](https://syn4pse.dev/terminal/square-mcp-server-remote.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
