Square logo
ConnectorSquare

Square integration for Claude and Codex

Create a Square connection, then control which Spaces can use its approved tools and data without pasting credentials into prompts or threads.

Use Square from Claude

Add the Square connection to a Space that runs Claude, then use it from every channel in that Space.

Use Square from Codex

Add the Square connection to a Space that runs Codex, then use it from every channel in that Space.

Use Square from Sidekick

Connect your own OpenClaw to Sidekick while Type provides the conversations, permissions, connections, skills, and automations.

Commerce & Payments

What the Square connector can do

Square provides payment processing, POS systems, invoicing, and e-commerce tools, enabling sellers to accept card payments and manage their business

One connection, many Spaces

Connect Square once, then decide which Spaces can use it in threads, skills, automations, and coding work.

Representative actions

  • Accept Dispute

    Accept a dispute and acknowledge liability, returning funds to the cardholder. When you accept a dispute, Square debits the disputed amount from your account and updates the dispute state to ACCEPTED. This action is irreversible - once accepted, a dispute cannot be challenged. Only use after reviewing all evidence and determining that challenging the dispute is not viable. Note: Requires DISPUTES_WRITE permission scope.

  • Add Group to Customer

    Tool to add a customer to a customer group. Use when you need to associate a customer with a specific group for targeted marketing, loyalty programs, or customer segmentation.

  • Calculate Order

    Tool to preview order pricing without creating an order. Use when you need to calculate the total cost, taxes, discounts, and other pricing details for an order before finalizing it. Particularly useful for integrating rewards, discounts, and complex pricing scenarios.

  • Cancel Invoice

    Cancels a Square invoice, preventing further payments from being collected. Requirements: - Invoice must be in SCHEDULED, UNPAID, or PARTIALLY_PAID state - Cannot cancel invoices in DRAFT state or terminal states (PAID, REFUNDED, CANCELED, FAILED) - Requires INVOICES_WRITE and ORDERS_WRITE OAuth scopes - Version number must match the current invoice version to prevent conflicts After cancellation, the associated order status is set to CANCELED and webhook events are triggered.

  • Cancel Payment

    Cancels (voids) a payment that is in APPROVED status. This is typically used in delayed capture scenarios where a payment was authorized but not yet captured, allowing you to void the authorization before settlement. Important: Only payments with APPROVED status can be canceled. Attempting to cancel a payment in any other status (COMPLETED, PENDING, CANCELED, FAILED) will result in an error. Once canceled, the payment status changes to CANCELED and the card details status changes to VOIDED. Required permissions: PAYMENTS_WRITE

Connection

API and auth details

Square APIs support commerce workflows including payments, refunds, customers, orders, catalog items, subscriptions, invoices, terminals, inventory, locations, webhooks, POS flows, and official SDKs across common languages.

FAQ

Questions people ask before connecting Square

Can Claude use Square?

Yes. Add a Square connection to a Space that runs Claude, then use its approved tools and data from any channel in that Space.

Can Codex work with Square through Type?

Yes. Add a Square connection to a Space that runs Codex, then use its approved tools and data from any channel in that Space.

Is this the same as a Square MCP server?

Not exactly. Type uses connectors and connections to give selected Spaces access to approved app tools and data. Some connectors use hosted MCP, while others use OAuth, API keys, service accounts, or custom APIs.

More commerce & payments connectors