Square Model Context Protocol Server (Beta)
This project follows the Model Context Protocol standard, allowing AI assistants to interact with Square's connect API.
Quick Start
Get up and running with the Square MCP server using npx:
# Basic startup
npx square-mcp-server start
# With environment configuration
ACCESS_TOKEN=YOUR_SQUARE_ACCESS_TOKEN SANDBOX=true npx square-mcp-server start
# local runs
npx /path/to/project/square-mcp-serverReplace YOUR_SQUARE_ACCESS_TOKEN with your actual Square access token. You can obtain your access token by following the guide at Square Access Tokens. You can also set environment variables before running the command.
Remote MCP Server
Square now offers a hosted remote MCP server at:
https://mcp.squareup.com/sseThe remote MCP is recommended as it uses OAuth authentication, allowing you to log in with your Square account directly without having to create or manage access tokens manually.
Configuration Options
| Environment Variable | Purpose | Example |
|---|---|---|
ACCESS_TOKEN |
Your Square API access token | ACCESS_TOKEN=sq0atp-... |
SANDBOX |
Use Square sandbox environment | SANDBOX=true |
PRODUCTION |
Use Square production environment | PRODUCTION=true |
DISALLOW_WRITES |
Restrict to read-only operations | DISALLOW_WRITES=true |
SQUARE_VERSION |
Specify Square API version | SQUARE_VERSION=2025-04-16 |
