MCP server
Square MCP server
Square's official MCP server lets AI reach the whole Square API, from payments and customers to catalog, inventory and bookings, through one request tool.
- Official server
- Payments and billing
At a glance
- Maintained by
- Square (Block)
- Tools exposed
- 3 listed below
- Reviewed
- September 24, 2026
Why it matters
What it does and why it matters
Square runs payments, point of sale, appointments and inventory for many shops, restaurants and service businesses. Its official MCP server takes a compact approach: three tools that describe Square's services and types and make any API request. That gives an assistant access to payments, customers, orders, catalog, inventory, bookings and more.
For a shop owner, that means questions such as "what sold best this week" or "which items are low in stock" in plain English.
Because one tool can call almost any Square API, the access token decides what is possible. Use a token with only the permissions a workflow needs, test in the Square sandbox, and keep refunds, catalog changes and inventory adjustments behind approval. Square's sandbox makes it easy to test each workflow first.
Use cases
Best business use cases
Sales questions
Bookings
Customer lookups
Catalog updates
Tools
Available tools
Tool names as published by the maintainer at review time. Versions change, so check the repository for the current list.
Read and write: Read and write across the Square API (payments, customers, orders, catalog, inventory, bookings and more) through make_api_request.
-
get_service_infoLists the methods available for a Square API service.
-
get_type_infoGets parameter requirements for a method.
-
make_api_requestCalls the Square API.
Workflows
Example workflows
Weekly sales summary
-
1
Ask for this week's sales by item.
-
2
The assistant calls the orders API.
-
3
It groups results.
-
4
It compares with last week.
-
5
It sends a short summary.
Low-stock reorder list
-
1
Ask for items below their reorder level.
-
2
The assistant checks inventory.
-
3
It lists items and quantities.
-
4
You adjust the list.
-
5
You place orders with suppliers.
Prompts
Example prompts
“What were our top ten items by sales this week?”
“Which items are below five units in stock?”
“Show tomorrow's appointments at the downtown location.”
Setup
Installation and configuration
Examples for Claude Desktop and Claude Code. Replace the placeholder values with your own keys, and store secrets outside version control.
Claude Desktop: claude_desktop_config.json
{
"mcpServers": {
"mcp_square_api": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.squareup.com/mcp"
]
}
}
}Claude Code: terminal
claude mcp add --transport http square https://mcp.squareup.com/mcp- Hosted server: https://mcp.squareup.com/mcp (older SSE endpoint: https://mcp.squareup.com/sse).
- Local server: npx square-mcp-server start.
- Needs: Remote: OAuth with a Square account. Local: ACCESS_TOKEN environment variable (SANDBOX=true for sandbox)..
Security
Security considerations
-
Restricted keys
Use restricted keys or scoped sign-in that allow only the actions a workflow needs.
-
Test mode first
Build and test in sandbox or test mode before touching live money.
-
Approve money movement
Refunds, payouts, payments and deletions need a person to approve them.
-
Audit trail
Review actions taken through the general request tool.
Related servers
Servers that pair well with it
Stripe
Stripe's official MCP server lets AI search and read Stripe data, make changes with confirmation for sensitive actions, run analytics and search docs.
PayPal
PayPal's official MCP server lets AI create and send invoices, manage orders, refunds, disputes, subscriptions, shipment tracking and transactions.
QuickBooks Online
Intuit's official QuickBooks Online MCP server lets AI search and create customers, invoices, bills and payments and pull financial reports.
Keep exploring
Solutions and services that use it
Related services
View all related services- MCP integration Connect AI assistants to your CRM, files, databases and tools through Model Context Protocol servers, with safe permissions.
- Payment integration Stripe, PayPal and local gateways wired into your site or app, with receipts, refunds and reconciliation.
- Automation and Integrations CRM, payment and API integrations, MCP connections and workflows that stop people copying data by hand.
- Dashboards and reporting Dashboards that pull numbers from the systems you already use and show what matters without a spreadsheet.
- Ecommerce websites Online stores with clean product catalogs, simple checkout and the integrations that keep orders moving.
- Billing and payments Checkout, invoices, subscriptions, refunds and the accounting exports your finance team needs.
Solutions
View all solutions- Invoice processing Read supplier invoices, match them to orders and push approved ones into accounting, with exceptions flagged for review.
- Automated reporting Reports that build themselves from your systems on schedule, with a plain-language summary of what changed.
- Forecasting dashboards Forecast demand from your sales history and seasonality, and flag items to reorder before they run out.
- Receipt capture and matching Snap a receipt, and the details are read, categorized and matched to the card transaction and the right project.
Industries
View all industries- Retail Stock forecasting, sales dashboards, feedback analysis and store tools for retailers with shops and online sales.
- Vacation rentals Booking websites, owner and guest portals, turnover scheduling and guest messaging for rental operators.
- Finance and accounting Client portals, document collection, invoice and receipt processing, and reporting for accounting firms and finance teams.
- Logistics and transportation Driver apps, order and shipment tracking, document processing and integrations for logistics and delivery companies.
- Property management Tenant portals, maintenance tracking, owner statements and inbox automation for property managers.
- Construction and facilities Job tracking, maintenance requests, inspections, quotes and proof-of-work photos for builders and facility teams.
Case studies
View all case studiesGuides and articles
View all guides and articles- How to connect AI to your database safely Let staff ask questions of your data in plain English without risking production systems or sensitive records.
- How to set up automated reporting Replace manual weekly and monthly reports with dashboards and summaries that update themselves.
- How to automate reporting with AI and MCP Build reports that assemble themselves from your systems through MCP, with a written summary people can trust.
- PostgreSQL vs MySQL The two most popular open-source databases compared for business applications.
Glossary terms
View all glossary terms- API integration An API integration connects two or more systems through their APIs so data and actions flow between them automatically.
- Database A database is an organized store of data that software can search, update and keep consistent, such as customers, orders or bookings.
- Webhook A webhook is an automatic message one system sends to another's web address when something happens, such as a payment or a new order.
- API An API, or application programming interface, is a defined way for one piece of software to request data or actions from another.
- Backend The backend is the part of an application that runs on servers, storing data, applying business rules and serving the frontend through APIs.
- MCP server An MCP server is a program or hosted service that exposes a system's data and actions as tools that AI assistants can use through the Model Context Protocol.
FAQ
Questions people ask us
Have a question that is not here? Ask us directly.
Yes. It is maintained by Square.
One general request tool can call the whole Square API, with two tools to describe services and types.
Yes, through the Square Bookings API.