How to
How to connect Claude to Square
Square publishes an official native Claude connector, but it ships a fixed, standard tool set covering a generic slice of the platform. Here is how teams get catalog edits, inventory adjustments, order work, and gated refunds shaped to their locations.
Connect Claude to Square either with the official connector, which ships a fixed, standard tool set covering a generic slice of the platform, or with a custom MCP connector when you need more. A custom build adds catalog edits, inventory and order actions, customer updates, location scoping, and gated refunds, authenticated as your own Square account.
Key takeaways
- Square publishes an official native Claude connector, but its tool set is fixed and standard, covering a generic slice of the platform rather than your workflow.
- A custom connector adds catalog edits, inventory adjustments, order and customer actions, and location scoping shaped to how your business runs.
- Write tools like `update_item`, `adjust_inventory`, and `create_order` do the dashboard clicking for you, and every write is scoped to the locations you choose.
- Money actions stay gated: `issue_refund` prepares the refund and shows you exactly what it will do, but it runs only after you confirm.
Does Square have an official Claude connector?
Yes. Square publishes an official native Claude connector. It ships a fixed, standard set of tools that covers a generic slice of the platform, which is useful for surfacing what is selling but is not shaped to a specific team's catalog, locations, or order workflow. Deeper write work is where custom connectors come in.
Start with the honest version: if you mainly want Claude reading your Square data, sales, catalog, customers, the official connector is worth connecting first. Generic coverage is still coverage.
The friction shows up when you want changes made. Repricing part of the catalog, adjusting inventory after a stock check, fixing an order, or issuing a refund are write actions that need scopes granted to specific locations and a confirmation step you control. A fixed generic tool set is not built around that; a custom Square connector is.
The wider pattern holds beyond this one tool: in our June 2026 review of 264 business tools, 77 percent had no Claude connector at all, and none shipped full read-write out of the box.
How do I set up a custom Square connector for Claude?
A custom Square connector is built for you as a small MCP server that authenticates with Square OAuth using the narrowest scopes the work needs, limited to the locations you choose. Read and write tools are separated, and money actions like refunds always wait for your confirmation.
The path from request to working connector:
- 1Describe the Square work Claude should handle, including which locations are in scope and which actions must always be confirmed.
- 2We build a small MCP server with read tools (catalog, orders, customers) separated from write tools (edit item, adjust inventory, refund).
- 3You authenticate through Square OAuth as your own account, so Claude inherits your existing permissions and location scopes and never exceeds them.
- 4Claude starts working your catalog and orders in conversation, and destructive or outbound actions like issuing a refund run only after you confirm them.
Access is revocable at any time, scopes stay as narrow as the work allows, and the server can sit behind IP allowlisting where your setup calls for it.
What can Claude do in Square with write access?
With full read-write access, Claude updates catalog item prices and descriptions, creates items with variations assigned to a category, adjusts inventory counts for a location after a stock check, creates or modifies orders and applies discounts, updates customer records, and prepares refunds for your approval.
The tool set maps to the dashboard clicking a busy operator does every week:
update_itemto change a catalog item's price or description.create_itemto add a catalog item with variations and assign it to a category.adjust_inventoryto correct counts for a location after a stock check.create_orderto create or modify an order and apply a discount.update_customerto add or update a record in the customer directory.issue_refundto prepare a refund against a payment, applied once you approve it.
Every write tool is scoped to the locations you pick, so a catalog cleanup at one store cannot leak into another.
Will Claude issue refunds or change orders without my approval?
No. Refunds and order changes are separate, gated write actions. Claude can prepare the refund or the order edit and show you exactly what it will do, but it runs only after you approve. You decide which actions are automatic and which always require a confirmation step.
Money deserves the strictest gate, and it gets one. In practice, most teams let catalog and customer reads flow freely, keep item and inventory edits fast, and require explicit confirmation for anything touching payments, refunds, or order totals. The line is yours to draw, per action.
Claude only has your access
The connector authenticates through Square OAuth and inherits your existing permissions and location scopes. It never grants Claude more access to your Square account than you already have, and you can limit it to specific locations and a narrow set of write scopes.
When is the official Square connector enough, and when is it not?
The official connector is enough when a fixed, generic tool set covers your needs, mostly reading sales, catalog, and customer data. It stops being enough when you want catalog edits, inventory adjustments, order changes, location scoping, or refunds behind your own approval gate. Those are custom-connector territory.
A quick self-test: write down the last five things you wished Claude had done in Square. If they are all lookups, connect the official connector today. If any involve changing a price, correcting a count, editing an order, or refunding a payment, you need write scopes granted to the locations you choose, a confirmation step in front of money actions, and a tool set built for your workflow, which is exactly what a purpose-built connector delivers.