• PROFILE
  • HISTORY
  • DETAILS
  • HUMAN

How to lookup customer order history with your AI

Connect Square to your AI client once. From then on, you can pull up any customer's purchase history just by asking.

Ask AI about this page

Short answer

How can I see what a customer bought?

Tell your AI the customer's name or email to pull their profile and a list of their previous orders. You'll get specific details on items purchased and transaction history. Here is the breakdown of how it works.

The outcomes

What you get from your AI

Your agent handles the heavy lifting of searching through Square data.

PROFILE

Customer details

The AI finds the right person in your Square database. You get their contact info and profile details immediately.

HISTORY

Purchase lists

Your agent scans through previous transactions. You get a clear list of what that customer bought over time.

DETAILS

Order specifics

The AI pulls full line-item breakdowns for specific transactions. You'll see exactly what was in a single order.

HUMAN

Manual updates

The AI only reads data. You still need to log into Square to change an order or issue a refund.

The workflow

What your AI does when the request arrives.

Your agent turns your questions into specific data requests.

  1. Find the customer

    The AI searches your Square customer list to find a match based on the name or email you provide.

    search_customers
  2. Get profile info

    Once the match is found, the AI pulls the full profile for that specific individual.

    get_customer
  3. Locate orders

    The AI looks through the customer's history to find all associated transactions.

    search_orders
  4. Pull order details

    For any specific order you ask about, the AI grabs the full itemized breakdown.

    get_order_details

Try it

Copy these to start.

Use these prompts to begin interacting with your Square data.

Starting points

Replace the names and emails with the actual customer info you need.

Square Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_GDy72INcPM9RV3RjZhDapqmLtt9g9XeoHRKWNwVk/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Square capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "square-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_GDy72INcPM9RV3RjZhDapqmLtt9g9XeoHRKWNwVk/mcp"
    }
  }
}
Copy into chat04
  • Find the customer profile for Jane Doe.

  • Show me all past orders for jane.doe@email.com.

  • What did the customer with email sam@example.com buy in their last order?

  • Get the details for the most recent order from Marcus Smith.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Square once, then ask.

Click the link to authorize the connection. Your login stays encrypted on our side, and the full walkthrough lives on the Connector page.

Connect Square to your AI

FAQ

How this task behaves

  • 01

    Can the AI delete a customer from Square?

    No. The AI can only read and retrieve data. It cannot delete or remove any records.

  • 02

    Can I use this to issue refunds?

    No. This MCP is for looking up information. You must use the Square dashboard to issue refunds or modify orders.

  • 03

    Can the AI update a customer's phone number?

    No. The tools provided are for searching and retrieving information, not for writing or updating data.

  • 04

    Does the AI see all my Square data?

    The AI only accesses the data required to answer your specific questions using the provided tools.

  • 05

    Can I search for orders by date range?

    Yes, you can ask your AI to find orders from a specific timeframe, and it will use the search tools to find them.

  • More questions about Square? The Connector page answers them. See everything the Square Connector can do

Connect Square to Claude, Cursor, ChatGPT & more