24 actions ready for your AI

Connect Square to your AI

Connect Square once and every AI you use can list customers, create customers and list customer groups through it.

Needs your API keyWorks today: paste the key from this app and your AI can use it. One-click sign-in is not built yet.

Not verified by us yet. Its actions come from Square's own documented API, and we have not run them here yet.

Use your own Square account. Credentials stay encrypted in ahel.

Tell me when ahel has verified Square

What your AI can do with Square

Choose a task and ask your AI.

Customer

  • List customersGET

    ListCustomers

    cursor
    A pagination cursor returned by a previous call to this endpoint.
    limit
    The maximum number of results to return in a single page.
    sort_field
    Indicates how customers should be sorted.
    sort_order
    Indicates whether customers should be sorted in ascending (ASC) or descending (DESC) order.
  • Create customerPOST

    CreateCustomer

    address
    Represents a postal address in a country.
    birthday
    The birthday associated with the customer profile, in RFC 3339 format.
    company_name
    A business name associated with the customer profile.
    email_address
    The email address associated with the customer profile.
  • List customer groupsGET

    ListCustomerGroups

    cursor
    A pagination cursor returned by a previous call to this endpoint.
    limit
    The maximum number of results to return in a single page.
  • Create customer groupPOST

    CreateCustomerGroup

    grouprequired
    Represents a group of customer profiles.
    idempotency_key
    The idempotency key for the request.
  • Search customersPOST

    SearchCustomers

    cursor
    Include the pagination cursor in subsequent calls to this endpoint to retrieve the next set of results associated with the original query.
    limit
    The maximum number of results to return in a single page.
    query
    Represents a query (including filtering criteria, sorting criteria, or both) used to search for customer profiles.
  • List customer segmentsGET

    ListCustomerSegments

    cursor
    A pagination cursor returned by previous calls to ListCustomerSegments.
    limit
    The maximum number of results to return in a single page.
  • Create customer cardPOST

    CreateCustomerCard

    customer_idrequired
    The Square ID of the customer profile the card is linked to.
    card_noncerequired
    A card nonce representing the credit card to link to the customer.
    billing_address
    Represents a postal address in a country.
    cardholder_name
    The full name printed on the credit card.
  • Retrieve customerGET

    RetrieveCustomer

    customer_idrequired
    The ID of the customer to retrieve.
  • Retrieve customer groupGET

    RetrieveCustomerGroup

    group_idrequired
    The ID of the customer group to retrieve.
  • Retrieve customer segmentGET

    RetrieveCustomerSegment

    segment_idrequired
    The Square-issued ID of the customer segment.

Loyalty

  • Create loyalty accountPOST

    CreateLoyaltyAccount

    idempotency_keyrequired
    A unique string that identifies this CreateLoyaltyAccount request.
    loyalty_accountrequired
    Describes a loyalty account.
  • List loyalty programsGET

    ListLoyaltyPrograms

  • Create loyalty rewardPOST

    CreateLoyaltyReward

    idempotency_keyrequired
    A unique string that identifies this CreateLoyaltyReward request.
    rewardrequired
    Represents a contract to redeem loyalty points for a reward tier discount.

Break

  • List break typesGET

    ListBreakTypes

    location_id
    Filter the returned BreakType results to only those that are associated with the specified location.
    limit
    The maximum number of BreakType results to return per page.
    cursor
    A pointer to the next page of BreakType results to fetch.
  • Create break typePOST

    CreateBreakType

    break_typerequired
    A defined break template that sets an expectation for possible Break instances on a Shift.
    idempotency_key
    A unique string value to ensure the idempotency of the operation.

Location

  • List locationsGET

    ListLocations

  • Create locationPOST

    CreateLocation

Show 6 more groups

Shift

  • Create shiftPOST

    CreateShift

    shiftrequired
    A record of the hourly rate, start, and end times for a single work shift for an employee.
    idempotency_key
    A unique string value to ensure the idempotency of the operation.
  • Search shiftsPOST

    SearchShifts

    cursor
    An opaque cursor for fetching the next page.
    limit
    The number of resources in a page (200 by default).
    query
    The parameters of a Shift search query, which includes filter and sort options.

Employee

  • List employee wagesGET

    ListEmployeeWages

    employee_id
    Filter the returned wages to only those that are associated with the specified employee.
    limit
    The maximum number of EmployeeWage results to return per page.
    cursor
    A pointer to the next page of EmployeeWage results to fetch.

Gift

  • List gift cardsGET

    ListGiftCards

    type
    If a type is provided, gift cards of this type are returned (see GiftCardType).
    state
    If the state is provided, it returns the gift cards in the specified state (see GiftCardStatus).
    limit
    If a value is provided, it returns only that number of results per page.
    cursor
    A pagination cursor returned by a previous call to this endpoint.

Order

  • Create orderPOST

    CreateOrder

    idempotency_key
    A value you specify that uniquely identifies this order among orders you have created.
    order
    Contains all information related to a single order to process with Square, including line items that specify the products to purchase.

Team Member

  • List team member wagesGET

    ListTeamMemberWages

    team_member_id
    Filter the returned wages to only those that are associated with the specified team member.
    limit
    The maximum number of TeamMemberWage results to return per page.
    cursor
    A pointer to the next page of EmployeeWage results to fetch.

Workweek

  • List workweek configsGET

    ListWorkweekConfigs

    limit
    The maximum number of WorkweekConfigs results to return per page.
    cursor
    A pointer to the next page of WorkweekConfig results to fetch.

Ask your AI

Try one of these requests with a connected AI.

  • List my customers in Square
  • Create a customer in Square
  • List my customer groups in Square
  • Create a customer group in Square
  • Find customers in Square
  • List my customer segments in Square

Published servers for Square

Built by the community and served through your gateway with the same key. A curated pick is one ahel has checked.

Square MCP server, hosted by ahel

One hosted endpoint serves Square. There is nothing to install and no local server to run.

Connect Square to Claude, Claude Code, Cursor or Codex

  1. Add your Square key. ahel stores it encrypted.
  2. Paste one link into your AI: https://mcp.ahel.ai (once, for every app).
  3. Ask for the work. Your AI picks the action and ahel runs it with your key.

Documentation

About Square

Square is a payments service. Connect your own Square account, by signing in or with a key, and ahel holds it sealed and signs your AI's calls with it.

Square over MCP: ahel serves Square to Claude, Claude Code, Cursor and Codex as one hosted MCP endpoint. There is no local server to run. Add your Square key once, paste one link into your AI, and the actions above are there.

Payments

Questions

Is my Square key safe?

Your Square key is sealed in ahel and added to the request server-side when your AI calls Square. It never crosses the MCP link, no tool can read it back, and you can turn the app off or remove the key at any time.

Which AIs can use Square through ahel?

Any MCP-capable AI: Claude, Claude Code, Codex, Cursor, VS Code and others. Paste one link, https://mcp.ahel.ai, into the AI once and everything in your gateway arrives through it.

What can my AI do with Square?

24 actions today, covering customers, loyalties and breaks. Ask in plain language; your AI picks the action and ahel runs it with your key.

Does connecting Square cost anything?

Connecting apps is free during ahel's early access. Free, Pro and Team all cost nothing today, and the pricing page lists what each one includes. Square may bill you for API use under its own terms.