Square MCP Server
square/square-mcp-server
Integração nativa do Square em assistentes de IA via MCP
Ver no GitHubServidor Model Context Protocol (MCP) que integra a API Square com assistentes de IA como Claude e Goose. Permite operações completas em contas Square, desde gerenciamento de pagamentos até catálogos de produtos, com autenticação via OAuth ou access token.
Instalação
npx convez-ai square/square-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar operações de pagamento e transações Square
- Gerenciar inventário e catálogo de produtos remotamente
- Consultar dados de vendas e relatórios financeiros
- Processar pedidos e refunds programaticamente
- Sincronizar dados entre Square e outros sistemas
Veredito

MCP server oficial e bem documentado da Square que simplifica drasticamente a integração com IA. Oferece autenticação segura via OAuth, modo sandbox para testes e suporte tanto local quanto remoto, tornando-o pronto para produção em automações financeiras e de e-commerce.
README
A tradução para o português deste README ainda está na fila.
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-server
Replace 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/sse
The 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 |
Integration with AI Assistants
Goose Integration
To configure the Square MCP Server with Goose:
Remote MCP
To install the Square remote MCP in Goose, click this URL on a computer where Goose is installed:
Or copy and paste the URL into your browser's address bar.
# Automatic installation
npx square-mcp-server install
# Get URL for manual installation
npx square-mcp-server get-goose-url
The install command automatically updates your Goose configuration.
Claude Desktop Integration
For Claude Desktop integration, see the Model Context Protocol Quickstart Guide. Add this configuration to your claude_desktop_config.json:
Remote MCP
{
"mcpServers": {
"mcp_square_api": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.squareup.com/sse"]
}
}
}
This approach allows you to authenticate directly with your Square account credentials without needing to manage access tokens.
Local MCP
{
"mcpServers": {
"mcp_square_api": {
"command": "npx",
"args": ["square-mcp-server", "start"],
"env": {
"ACCESS_TOKEN": "YOUR_SQUARE_ACCESS_TOKEN",
"SANDBOX": "true"
}
}
}
}
Tool Reference
The Square MCP Server provides a streamlined set of tools for interacting with Square APIs:
| Tool | Description | Primary Use |
|---|---|---|
get_service_info | Discover methods available for a service | Exploration and discovery |
get_type_info | Get detailed parameter requirements | Request preparation |
make_api_request | Execute API calls to Square | Performing operations |
Service Catalog
Square MCP Server provides access to Square's complete API ecosystem. Check out the Square API Documentation for detailed information about each service:
| Service | Description |
|---|---|
applepay | Apple Pay integration |
bankaccounts | Bank account management |
bookingcustomattributes | Custom attributes for bookings |
bookings | Appointment booking management |
cards | Payment card management |
cashdrawers | Cash drawer management |
catalog | Catalog management (items, categories, etc.) |
checkout | Checkout and payment processing |
customercustomattributes | Custom attributes for customers |
customergroups | Customer grouping |
customersegments | Customer segmentation |
customers | Customer management |
devices | Square device management |
disputes | Payment dispute handling |
events | Event tracking |
giftcardactivities | Gift card activity tracking |
giftcards | Gift card management |
inventory | Inventory tracking |
invoices | Invoice management |
labor | Workforce management |
locationcustomattributes | Custom attributes for locations |
locations | Location management |
loyalty | Loyalty program management |
merchantcustomattributes | Custom attributes for merchants |
merchants | Merchant account management |
oauth | Authentication |
ordercustomattributes | Custom attributes for orders |
orders | Order management |
payments | Payment processing |
payouts | Payout management |
refunds | Refund management |
sites | Website integration |
snippets | Square Online Code integration |
subscriptions | Subscription management |
team | Staff management |
terminal | Square Terminal management |
vendors | Supplier management |
webhooksubscriptions | Event notifications |
Usage Pattern
For optimal interaction with the Square API through MCP:
-
Discover: Use
get_service_infoto explore available methodsget_service_info(service: "catalog") -
Understand: Use
get_type_infoto learn parameter requirementsget_type_info(service: "catalog", method: "list") -
Execute: Use
make_api_requestto perform the operationmake_api_request(service: "catalog", method: "list", request: {})
Development and Debugging
Using MCP Inspector
The MCP Inspector provides a visual interface for testing:
# Build the project
npm run build
# Start the inspector with the Square MCP Server
npx @modelcontextprotocol/inspector node dist/index.js start
Development Workflow
- Clone the repository
- Install dependencies:
npm install - Start development mode:
npm run watch - Run the server:
node dist/index.js start - Test your changes using the MCP Inspector
Contributing
This repository is auto-generated from Square's OpenAPI Specification. While contributions are welcome, please note that changes will need to be incorporated into the generator that produces this code. Please open an issue to discuss proposed changes before submitting a pull request.