Skip to content
Square logo

Square MCP server

Payment solutions for every business

Square is not a separate install. One Activepieces MCP server exposes it alongside 770+ other apps, behind a single URL.

Tools
28
Works with
Any MCP client
Auth
OAuth 2.0
License
MIT, open source
Updated
October 2026

About the Square MCP server

Connect Square once in Activepieces and every action it ships becomes a tool your assistant can call, behind the same server URL as the rest of your apps. Your agent reaches Square and 770+ other apps over a single connection, on our cloud or a self-hosted install.

Tools

Square tools your AI can run

Once connected, your assistant can call any of these Square actions by asking in plain language.

  • Get Business Profile

    Gets the connected Square business: name, country, currency and main location.

  • List Locations

    Lists the business locations (stores) of the Square account.

    1 field

  • List Team Members

    Lists staff members of the Square account. Needs a connection created or reconnected with piece version 1.0.0 or later.

    4 fields

  • Create Customer

    Adds a customer profile to the Square Customer Directory.

    16 fields

  • Find Customers

    Searches customers by email, phone, reference ID or creation date.

    8 fields

  • Get Customer

    Gets a customer profile.

    1 field

  • Update Customer

    Changes fields on a customer profile. Empty fields keep their current value.

    17 fields

  • Delete Customer

    Permanently deletes a customer profile.

    1 field

  • Search Catalog Items

    Finds products and services in the Square catalog by name, category or location.

    5 fields

  • Get Catalog Item

    Gets a catalog item with its variations and prices.

    1 field

  • Create Catalog Item

    Adds a product or service with one price to the Square catalog.

    8 fields

  • Update Item Price

    Changes the price, SKU or name of an item variation.

    6 fields

  • Delete Catalog Item

    Permanently deletes a catalog item (with all its variations) or a single variation.

    1 field

  • Get Inventory Count

    Gets the stock count of an item variation. Needs a connection created or reconnected with piece version 1.0.0 or later.

    3 fields

  • Adjust Inventory

    Adds or removes stock for an item variation. Needs a connection created or reconnected with piece version 1.0.0 or later.

    6 fields

  • Set Inventory Count

    Sets the in-stock count of an item variation after a stock take. Needs a connection created or reconnected with piece version 1.0.0 or later.

    4 fields

  • Create Order

    Creates an open order (no payment is taken).

    5 fields

  • Get Order

    Gets an order with its line items and totals.

    1 field

  • Search Orders

    Finds orders by location, state, customer and creation date, newest first.

    7 fields

  • Complete or Cancel Order

    Marks an open order as completed or canceled.

    2 fields

  • Get Payment

    Gets a payment with its amount, status and card summary.

    1 field

  • List Payments

    Lists payments in a time range, newest first.

    5 fields

  • Record Cash or External Payment

    Records money you received outside Square (cash, check, bank transfer, another app). Never charges a card. Needs a connection created or reconnected with piece version 1.0.0 or later.

    11 fields

  • Refund Payment

    Refunds all or part of a payment. Card refunds send real money back to the buyer and cannot be undone. Needs a connection created or reconnected with piece version 1.0.0 or later.

    4 fields

  • Get Refund

    Gets a refund and its status.

    1 field

  • List Refunds

    Lists refunds in a time range, newest first.

    6 fields

  • Create Payment Link

    Creates a Square checkout link for a fixed amount that you can send to a buyer. Needs a connection created or reconnected with piece version 1.0.0 or later.

    8 fields

  • Custom API Call

    Make a custom API call to a specific endpoint

    10 fields

Triggers

Square events your agent can watch

These start a run the moment something happens in Square, so work gets picked up on its own.

  • New Order

    Triggered when a new order is created

    2 fields

  • Order Updated

    Triggered when an order is updated

    2 fields

  • New Customer

    Triggered when a customer is created

  • Customer Updated

    Triggered when a customer is updated

  • New Payment

    Triggered when a new payment is created

    1 field

Give your assistant Square

Connect Square once and every tool above is callable from Claude, Cursor or any MCP client, behind the same server URL as 770+ other apps. Free to start.

Square MCP, answered.

No. That is the point of it. One Activepieces server exposes Square alongside every other piece you connect, so your client keeps a single connection.

Yes. Activepieces is open source and free to start, and the MCP server is included on every plan, from the free cloud tier to any self-hosted deployment.

Connect Square in Activepieces, enable the server under Settings → MCP Server, then paste your server URL into your client config. It authenticates over OAuth on first use.

It can call 28 tools, including Get Business Profile, List Locations, List Team Members, and chain them with steps in other apps inside the same run.

Connections use OAuth2 with limited scopes and are stored under 256-bit encryption, with no API to read them back, so an agent gets scoped access rather than your keys.