Square MCP Server
Provides MCP resources and tools for AI assistants to access/manage payments, orders, customers, inventory (catalog), and labor/scheduling data in Square.
payment
DatasetRetrieves details for a specific payment transaction.
customer
DatasetCustomer profile associated with a Square account.
order
DatasetA single order containing line items, totals, and state.
team_member
DatasetManages team members for a Square seller.
job
DatasetDefines job descriptions and compensation settings.
breaktype
DatasetDefines a type of break that can be taken during a shift.
teammemberwage
DatasetPaginated list of TeamMemberWage instances for a business.
workweekconfig
DatasetReturns a list of WorkweekConfig instances for a business.
timecard
DatasetRecords a team member's clock-in and clock-out times.
scheduledshift
DatasetA planned work period for a team member.
merchant
DatasetProvides details about the merchant associated with a given access token.
location
DatasetProvides details about all of the seller's locations, including those with an inactive status.
catalog_api_info
DatasetRetrieves information about the Square Catalog API, such as batch size limits.
catalog_object_list
DatasetReturns a list of all CatalogObjects (Items, Categories, Taxes, etc.) of the specified types in the catalog.
catalog_item
DatasetA product or service offered by the seller (CatalogObject type ITEM).
create_payment
ToolCreates a payment using the provided source.
cancel_payment_by_idempotency_key
ToolCancels (voids) a payment identified by the idempotency key that is specified in the request.
update_payment
ToolUpdates a payment with the APPROVED status.
cancel_payment
ToolCancels (voids) a payment.
complete_payment
ToolCompletes (captures) a payment.
create_customer
ToolCreates a new customer for a business.
bulk_create_customers
ToolCreates multiple customer profiles for a business.
bulk_delete_customers
ToolDeletes multiple customer profiles.
bulk_retrieve_customers
ToolRetrieves multiple customer profiles.
bulk_update_customers
ToolUpdates multiple customer profiles.
search_customers
ToolSearches the customer profiles associated with a Square account using one or more supported query filters.
update_customer
ToolUpdates a customer profile.
delete_customer
ToolDeletes a customer profile from a business.
remove_group_from_customer
ToolRemoves a group membership from a customer.
add_group_to_customer
ToolAdds a group membership to a customer.
update_order
ToolUpdates an existing order using sparse objects. Requires order.version for optimistic concurrency.
create_order
ToolCreates a new order object, optionally including line items, taxes, and discounts, using either catalog references or ad hoc details.
search_orders
ToolFinds orders that match filtering criteria across specified locations. Results can be filtered by customer, fulfillment state/type, source, order state, and date/time range.
pay_order
ToolCompletes the payment process for an existing order using the Orders API.
create_team_member
ToolCreate a single team member, including profile and wage settings.
bulk_create_team_members
ToolCreate multiple team members (1 to 25) in a bulk operation.
update_team_member
ToolUpdate an existing team member profile.
bulk_update_team_members
ToolUpdate multiple team members in bulk.
create_job
ToolCreate a new job.
update_job
ToolUpdate an existing job definition.
update_wage_setting
ToolCreates or updates a WageSetting object.
search_team_members
ToolSearches for team members based on criteria (e.g., location, status).
create_break_type
ToolCreates a new BreakType.
delete_break_type
ToolDeletes an existing BreakType.
update_break_type
ToolUpdates an existing BreakType.
create_scheduled_shift
ToolCreates a scheduled shift by providing draft shift details such as job ID, team member assignment, and start and end times.
bulk_publish_scheduled_shifts
ToolPublishes 1 - 100 scheduled shifts.
search_scheduled_shifts
ToolReturns a paginated list of scheduled shifts, with optional filter and sort settings.
update_scheduled_shift
ToolUpdates the draft shift details for a scheduled shift.
publish_scheduled_shift
ToolPublishes a scheduled shift.
create_timecard
ToolCreates a new Timecard.
search_timecards
ToolReturns a paginated list of Timecard records for a business.
delete_timecard
ToolDeletes a Timecard.
update_timecard
ToolUpdates an existing Timecard.
update_workweek_config
ToolUpdates a WorkweekConfig.
create_location
ToolCreates a location.
update_location
ToolUpdates a location.
batch_delete_catalog_objects
ToolDeletes a set of CatalogItems based on the provided list of target IDs and returns a set of successfully deleted IDs.
batch_retrieve_catalog_objects
ToolReturns a set of objects based on the provided ID.
batch_upsert_catalog_objects
ToolCreates or updates up to 10,000 target objects based on the provided list of objects.
create_catalog_image
ToolUploads an image file to be represented by a CatalogImage object that can be linked to an existing CatalogObject instance.
update_catalog_image
ToolUploads a new image file to replace the existing one in the specified CatalogImage object.
upsert_catalog_object
ToolCreates a new or updates the specified CatalogObject.
delete_catalog_object
ToolDeletes a single CatalogObject based on the provided ID.
retrieve_catalog_object
ToolRetrieves a single CatalogObject based on the provided ID.
search_catalog_objects
ToolSearches the Square Catalog for objects based on criteria (e.g., type, query text).
search_catalog_items
ToolSearches for CatalogItem objects based on criteria (e.g., location, category, tax).
update_item_modifier_lists
ToolUpdates the modifier lists associated with an item.
update_item_taxes
ToolUpdates the taxes associated with an item.
Square Resources
Square MCP Server
Connect your AI to Square data through the Model Context Protocol.
- Granularly control which tools your AI can access
- Full visibility with logging and auditing
- Standard MCP protocol - no custom wrappers needed
Select a dataset or tool from the left to see more details
Universal MCP Server for Square
Connect Claude, Microsoft Copilot, and any MCP-compatible AI to Square. One server, instant access to datasets, tools, and workflows.
- Model Context Protocol: Industry standard supported by Claude and Microsoft Copilot
- Fine-Grained Control: Choose exactly which datasets and tools your AI can access
- Connect Once, Use Everywhere: Single authentication for all your AI assistants
Get Started with Your Favorite AI Tool
Follow our step-by-step guides for popular AI frameworks and tools