How to connect Square to Claude

Connect Claude Web, Desktop and Cowork to Square MCP. Create and send an invoice to a customer, list all recent payments from last week, and more using natural language, with authentication handled for you.

Square logoSquare
Oauth2

Square is a platform for payment processing, POS, invoicing, and e-commerce. It empowers businesses to accept payments, manage sales, and streamline operations from one place.

96 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Square account to Claude via Composio Connect, enabling it to create and send an invoice to a customer, list all recent payments from last week, update item prices in your product catalog, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Square with

Connecting Square to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Square account

Back in Claude, ask it to connect to Square or give it any Square-related task.

For example, ask Claude to:

  • "Create and send an invoice to a customer"
  • "List all recent payments from last week"
  • "Update item prices in your product catalog"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Square account is ready to use.

What is the Square Claude Connector, and what's possible with it?

The Square MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Square account. It provides structured and secure access to your Square business tools, so your agent can perform actions like processing payments, managing invoices, tracking orders, handling customers, and managing inventory on your behalf.

  • Seamless payment processing: Let your agent accept card payments, issue refunds, and manage transactions across your business locations.
  • Automated invoice creation and management: Ask your agent to generate, send, and monitor invoices for your customers, streamlining your billing process.
  • Order and fulfillment tracking: Enable your agent to view, update, and manage orders, helping you keep tabs on fulfillment and delivery status with ease.
  • Customer profile management: Have your agent create, update, or search customer profiles, making it easier to personalize service and maintain up-to-date records.
  • Inventory and item catalog control: Allow your agent to track stock levels, update item details, and organize your catalog for smooth retail operations.

Troubleshooting

1. Why does Claude not use the Composio connector for Square?

The connector can show as connected, but Claude must use it in each Square conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Square again.

2. Why does Claude show an MCP server error before Square connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Square.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Square.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Square authorization link not work?

The Composio connector is one server. Your Square account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Square connection.
  • Composio creates a fresh Square authorization link.
  • Open that link in your browser and finish the Square sign-in.

4. Why do Square actions fail after they worked before?

The Square connection can expire or lose permission.

  • Ask Claude to inspect the Square connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Square account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Square.
  • If the action still fails with a permission error, check that the connected account has that permission in Square itself.

5. How do I switch to a different Square account?

Claude can manage the Square connection for you.

  • Ask Claude to disconnect or delete the current Square account.
  • Ask Claude to connect Square again.
  • Open the new Composio authorization link for Square.
  • Sign in with the other Square account in the browser.
  • After the account connects, ask Claude to retry the Square task.

6. Why is my Square connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Square connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click and click Clear cache.
  • If Square tools still do not appear, click , disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Square.
TOOLS

Supported Tools

Every Square action and event your agent gets out of the box.

Accept Dispute

Accept a dispute and acknowledge liability, returning funds to the cardholder.

Add Group to Customer

Tool to add a customer to a customer group.

Calculate Order

Tool to preview order pricing without creating an order.

Cancel Invoice

Cancels a Square invoice, preventing further payments from being collected.

Cancel Payment

Cancels (voids) a payment that is in APPROVED status.

Create Bulk Customers

Tool to create multiple customer profiles in a single request.

Create Card

Tool to create a card on file.

Create Customer

Tool to create a new customer profile in Square.

Create Customer Custom Attribute Definition

Tool to create a customer-related custom attribute definition.

Create Customer Group

Tool to create a new customer group for a business.

Create Dispute Evidence File

Tool to upload a file as dispute evidence.

Create Dispute Evidence Text

Upload text evidence for a dispute challenge.

Create Invoice Attachment

Upload and attach a file to a Square invoice.

Create Location

Tool to create a new business location in a Square account.

Create Location Custom Attribute Definition

Tool to create a location-related custom attribute definition.

Delete Customer

Tool to delete a Square customer profile.

Delete Customer Custom Attribute

Tool to delete a custom attribute from a customer profile.

Delete Customer Custom Attribute Definition

Tool to delete a customer-related custom attribute definition.

Delete Customer Group

Tool to delete a customer group by its ID.

Bulk Delete Customers

Tool to bulk delete customer profiles from Square.

Delete Dispute Evidence

Removes a specific piece of evidence from a dispute.

Delete Invoice

Tool to delete a Square invoice (only DRAFT invoices can be deleted).

Delete Invoice Attachment

Tool to delete an attachment from a Square invoice.

Delete Location Custom Attribute

Tool to delete a custom attribute from a location.

Delete Location Custom Attribute Definition

Tool to delete a location-related custom attribute definition.

Delete Locations Custom Attributes (Batch)

Tool to delete custom attributes from multiple locations in a single batch request.

Delete Merchant Custom Attribute

Tool to delete a custom attribute from a merchant profile.

Delete Merchant Custom Attribute Definition

Tool to delete a merchant-related custom attribute definition.

Delete Merchants Custom Attributes (Batch)

Tool to delete custom attributes from multiple merchants in a single batch request.

Delete Webhook Subscription

Permanently deletes a webhook subscription by its ID.

Get Business Booking Profile

Tool to retrieve the business booking profile for a Square merchant via GraphQL.

Get Current Merchant

Tool to retrieve merchant information associated with the access token using Square's GraphQL API.

Get Customer Custom Attribute

Retrieves a custom attribute from a customer profile in Square.

Get Customer Custom Attribute Definition

Tool to retrieve a customer-related custom attribute definition from Square.

Get Customers via GraphQL

Tool to retrieve customer profiles from Square Customer Directory using GraphQL API.

Get Dispute Evidence

Retrieves detailed information about a specific piece of evidence that was uploaded for a dispute.

Get Invoice

Retrieves detailed information about a specific Square invoice by its ID.

Get Merchant

Tool to retrieve detailed information about a specific Square merchant by ID.

Get Online Checkout Location Settings

Tool to retrieve location-level settings for Square online checkout.

List Channels

Tool to list requested channels from Square.

List Customer Custom Attribute Definitions

Tool to list customer-related custom attribute definitions from Square.

List Customer Custom Attribute Definitions (GraphQL)

Tool to retrieve customer custom attribute definitions via Square's GraphQL API.

List Customer Custom Attributes

Tool to list custom attributes for a customer profile.

List Customer Groups

Tool to retrieve the list of customer groups of a business.

List Customers

Tool to retrieve customer profiles associated with a Square account.

List Customer Segments

Tool to retrieve the list of customer segments of a business.

List Dispute Evidence

Tool to list evidence items associated with a given dispute.

List Invoices

Tool to list invoices for a Square location.

List Location Custom Attribute Definitions

Tool to list location-related custom attribute definitions from Square.

List Locations

Tool to retrieve all business locations from a Square account.

List Locations Custom Attributes

Tool to list custom attributes for a specific location in Square.

List Merchant Custom Attribute Definitions

Tool to list merchant-related custom attribute definitions from Square.

List Merchants

Tool to retrieve merchant account information associated with the access token.

List Merchants Custom Attributes

Tool to list custom attributes for a specific merchant in Square.

List Payments

Tool to list payments by location and time range to enable reconciliation and net sales reporting from Square POS.

List Webhook Event Types

Tool to list available webhook event types.

List Webhook Subscriptions

List all webhook subscriptions owned by your application.

Remove Group From Customer

Removes a customer from a customer group.

Retrieve Bulk Customers

Tool to retrieve multiple customer profiles in a single request.

Retrieve Channel

Retrieve a Square channel by its ID.

Bulk Retrieve Channels

Tool to bulk retrieve multiple Square channels by their IDs in a single request.

Retrieve Customer

Tool to retrieve detailed information about a specific Square customer by ID.

Retrieve Customer Group

Tool to retrieve a specific Square customer group by ID.

Retrieve Customer Segment

Tool to retrieve a specific customer segment by its ID.

Retrieve Dispute

Tool to retrieve a Square dispute by ID.

Retrieve Location

Tool to retrieve detailed information about a specific Square location by ID.

Retrieve Location Custom Attribute

Retrieves a custom attribute associated with a location in Square.

Retrieve Location Custom Attribute Definition

Tool to retrieve a location-related custom attribute definition.

Retrieve Merchant Custom Attribute

Retrieves a custom attribute associated with a merchant in Square.

Retrieve Merchant Custom Attribute Definition

Tool to retrieve a merchant-related custom attribute definition from Square.

Retrieve Merchants

Tool to retrieve merchant information including status, main location details, and capabilities using Square's GraphQL API.

Retrieve Order

Retrieves detailed information about a specific Square order by its ID.

Retrieve Payment Link

Retrieves a Square-hosted payment link by ID.

Retrieve Token Status

Tool to retrieve information about an OAuth access token or personal access token.

Retrieve Webhook Subscription

Retrieve a Square webhook subscription by its ID.

Search Customers

Tool to search customer profiles in Square Customer Directory.

Search Orders

Tool to search orders across one or more Square locations with filters.

Submit Dispute Evidence

Submits evidence for a dispute to the cardholder's bank.

Test Webhook Subscription

Tests a webhook subscription by sending a test event to the configured notification URL.

Update Customer

Tool to update an existing Square customer profile.

Update Customer Custom Attribute Definition

Tool to update a customer-related custom attribute definition in Square.

Update Customer Group

Tool to update a customer group's information by its ID.

Bulk Update Customers

Tool to update multiple customer profiles in a single batch operation.

Update Location

Tool to update an existing business location in a Square account.

Update Location Custom Attribute Definition

Tool to update a location-related custom attribute definition in Square.

Update Merchant Custom Attribute Definition

Tool to update a merchant-related custom attribute definition in Square.

Update Online Checkout Location Settings

Tool to update location-level settings for Square online checkout.

Update Order

Updates an existing Square order by adding, modifying, or removing fields.

Update Webhook Subscription

Tool to update a Square webhook subscription.

Update Webhook Subscription Signature Key

Tool to rotate the signature key for a webhook subscription.

Upsert Customer Custom Attribute

Tool to create or update a custom attribute for a customer profile.

Batch Upsert Customer Custom Attributes

Tool to create or update custom attributes for multiple customers in a single batch request.

Upsert Location Custom Attribute

Tool to create or update a custom attribute for a location.

Batch Upsert Locations Custom Attributes

Tool to create or update custom attributes for multiple locations in a single batch request.

Upsert Merchant Custom Attribute

Tool to create or update a custom attribute for a merchant profile.

Batch Upsert Merchants Custom Attributes

Tool to create or update custom attributes for multiple merchants in a single batch request.

FAQ

Frequently asked questions

With a standalone Square MCP server, the agents and LLMs can only access a fixed set of Square tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Square and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Square tools.

Yes, absolutely. You can configure which Square scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Square data and credentials are handled as safely as possible.

Start with Square.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Square tool your agent needs.Free to start.

Start building