← Catalog

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

  • square__get_merchant

    Fetch 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.
    Free

    Most other Square calls need a location id from here.

  • square__get_locationFetch one location.
    Free

    Pass "main" as the location id for the seller's main location.

  • square__list_customersList the seller's customer profiles.
    Free

    Newly created profiles can take up to a minute to appear.

  • square__get_customer

    Fetch one customer profile by id.

    Free
  • square__search_customers

    Search customer profiles by email, phone, reference id, creation source, group, segment or created/updated time range.

    Free
  • square__create_customerCreate a customer profile.
    Free

    At least one of given_name, family_name, company_name, email_address or phone_number is required.

  • square__update_customerUpdate a customer profile.
    Free

    Sparse: only the fields you pass change, and an explicit null clears one. Pass version for optimistic concurrency.

  • square__delete_customerDelete a customer profile.
    Free

    This cannot be undone.

  • square__search_orders

    Search orders across locations — every sale, return and exchange, whatever entered them (Point of Sale, invoices, APIs).

    Free
  • square__get_order

    Fetch one order by id, with its line items and totals.

    Free
  • square__create_orderCreate an order.
    Free

    Creating an order does not take payment — this connector never charges a card.

  • square__update_orderUpdate an open order.
    Free

    Send a sparse order carrying its current version; COMPLETED and CANCELED orders cannot be updated.

  • square__list_paymentsList payments taken by the seller, filterable by time range, location, amount and card.
    Free

    Read-only — this connector cannot take payments.

  • square__get_payment

    Fetch one payment by id.

    Free
  • square__list_refundsList refunds on the seller's payments.
    Free

    Read-only — this connector cannot issue refunds.

  • square__get_refund

    Fetch one refund by id.

    Free
  • square__search_catalog_objects

    Search any catalog object type (items, variations, categories, taxes, discounts, modifiers, images) by attribute queries.

    Free
  • square__search_catalog_items

    Search items and item variations by name/description text, category, product type, stock level or enabled location.

    Free
  • square__get_catalog_object

    Fetch one catalog object by id, optionally with the objects it references.

    Free
  • square__upsert_catalog_objectCreate or replace one catalog object.
    Free

    FULL REPLACEMENT: any field you omit is cleared and omitted inline children (such as item variations) are deleted, so send the complete object.

  • square__delete_catalog_objectDelete one catalog object.
    Free

    Cascades — deleting an item also deletes its variations.

  • square__list_invoices

    List the invoices for one location.

    Free
  • square__search_invoicesSearch invoices at a location, optionally narrowed to specific customers.
    Free

    Square accepts exactly one location and one customer today.

  • square__get_invoice

    Fetch one invoice by id, including its current version.

    Free
  • square__create_invoiceCreate a DRAFT invoice for an existing order.
    Free

    Nothing is sent or charged until publish_invoice runs.

  • square__update_invoiceUpdate an invoice.
    Free

    Sparse, and the invoice's current version is required inside the invoice object; order_id and location_id cannot change.

  • square__publish_invoicePublish a draft invoice, which makes Square act on it — typically emailing it to the customer.
    Free

    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.

  • square__cancel_invoiceCancel a published invoice so no further payment can be collected.
    Free

    Does not work on a DRAFT or on an invoice already PAID, REFUNDED, CANCELED or FAILED.

  • square__delete_invoiceDelete a DRAFT invoice; the associated order becomes CANCELED.
    Free

    Published invoices cannot be deleted — cancel them instead.

Pages about Square

Give this to your agent

set up https://corespeed.io/SKILL.md
Get started
FAQ

Questions people ask.