Square
Connect Square to Claude Code, Codex, Cursor or any MCP agent through CoreSpeed. Read a Square seller's merchant profile, locations, customers, orders, payments, refunds, catalog and invoices; create and update customers, orders, catalog objects and invoices. Your agent works through your own Square account and gets 30 Square tools; CoreSpeed holds the credential, so the agent never sees the token. Calling it is free.
Tools30
- Free
square__get_merchantFetch the connected Square seller's merchant profile (merchant id, business name, country, currency, status).
- Free
square__list_locationsList all of the seller's locations, including inactive ones.Most other Square calls need a location id from here.
- Free
square__get_locationFetch one location.Pass "main" as the location id for the seller's main location.
- Free
square__list_customersList the seller's customer profiles.Newly created profiles can take up to a minute to appear.
- Free
square__get_customerFetch one customer profile by id.
- Free
square__search_customersSearch customer profiles by email, phone, reference id, creation source, group, segment or created/updated time range.
- Free
square__create_customerCreate a customer profile.At least one of given_name, family_name, company_name, email_address or phone_number is required.
- Free
square__update_customerUpdate a customer profile.Sparse: only the fields you pass change, and an explicit null clears one. Pass version for optimistic concurrency.
- Free
square__delete_customerDelete a customer profile.This cannot be undone.
- Free
square__search_ordersSearch orders across locations — every sale, return and exchange, whatever entered them (Point of Sale, invoices, APIs).
- Free
square__get_orderFetch one order by id, with its line items and totals.
- Free
square__create_orderCreate an order.Creating an order does not take payment — this connector never charges a card.
- Free
square__update_orderUpdate an open order.Send a sparse order carrying its current version; COMPLETED and CANCELED orders cannot be updated.
- Free
square__list_paymentsList payments taken by the seller, filterable by time range, location, amount and card.Read-only — this connector cannot take payments.
- Free
square__get_paymentFetch one payment by id.
- Free
square__list_refundsList refunds on the seller's payments.Read-only — this connector cannot issue refunds.
- Free
square__get_refundFetch one refund by id.
- Free
square__search_catalog_objectsSearch any catalog object type (items, variations, categories, taxes, discounts, modifiers, images) by attribute queries.
- Free
square__search_catalog_itemsSearch items and item variations by name/description text, category, product type, stock level or enabled location.
- Free
square__get_catalog_objectFetch one catalog object by id, optionally with the objects it references.
- Free
square__upsert_catalog_objectCreate or replace one catalog object.FULL REPLACEMENT: any field you omit is cleared and omitted inline children (such as item variations) are deleted, so send the complete object.
- Free
square__delete_catalog_objectDelete one catalog object.Cascades — deleting an item also deletes its variations.
- Free
square__list_invoicesList the invoices for one location.
- Free
square__search_invoicesSearch invoices at a location, optionally narrowed to specific customers.Square accepts exactly one location and one customer today.
- Free
square__get_invoiceFetch one invoice by id, including its current version.
- Free
square__create_invoiceCreate a DRAFT invoice for an existing order.Nothing is sent or charged until publish_invoice runs.
- Free
square__update_invoiceUpdate an invoice.Sparse, and the invoice's current version is required inside the invoice object; order_id and location_id cannot change.
- Free
square__publish_invoicePublish a draft invoice, which makes Square act on it — typically emailing it to the customer.Only email/share delivery works here: this connector holds no PAYMENTS_WRITE grant, so an invoice configured to charge a card on file will be refused.
- Free
square__cancel_invoiceCancel a published invoice so no further payment can be collected.Does not work on a DRAFT or on an invoice already PAID, REFUNDED, CANCELED or FAILED.
- Free
square__delete_invoiceDelete a DRAFT invoice; the associated order becomes CANCELED.Published invoices cannot be deleted — cancel them instead.
Pages about Square
- Square for Claude Code, Codex, and Cursor · Ask your agent about Square orders, payments and customers, and draft invoices you review before they go out.