S
Official Finance & Sales

Square

Access Square payments, orders, customers, and catalog through the Square API.

Works with: Claude DesktopClaude CodeCursorWindsurf
Quick install
npx square-mcp-server start

How to install the Square MCP server

Add this to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "square": {
      "command": "npx",
      "args": [
        "square-mcp-server",
        "start"
      ]
    }
  }
}

Add this to your Claude Code MCP configuration:

npx square-mcp-server start

Add this to your Cursor MCP configuration:

{
  "mcpServers": {
    "square": {
      "command": "npx",
      "args": [
        "square-mcp-server",
        "start"
      ]
    }
  }
}

Add this to your Windsurf MCP configuration:

{
  "mcpServers": {
    "square": {
      "command": "npx",
      "args": [
        "square-mcp-server",
        "start"
      ]
    }
  }
}

Built by ContextBoltThis directory is built by ContextBolt: MCP-native memory and SEO tools that run alongside Square in the same client.

Explore ContextBolt

The Square MCP server is the official connector from Block for querying your Square account through Claude. It reaches payments, orders, customers, and your catalog, so a merchant or developer can ask questions about sales and inventory in plain language instead of building against the API by hand.

What it actually does

The server exposes the main Square data objects. You can look up recent transactions, inspect orders, pull customer records, and read or reason about your catalog and item list. It suits both quick business questions and light development work where you want to explore the data before writing real code.

Practical patterns:

  • ‘What were my total sales last week, broken down by day?’
  • ‘Show me the catalog items that are out of stock right now.’
  • ‘Find the last five orders from this customer and summarize what they bought.‘

Why use it

Square’s API is capable but verbose. Letting Claude translate a question into the right calls saves you from stitching together endpoints for a one-off report. For merchants who are not developers, it turns account data into something you can just ask about.

Gotchas

The server is in beta, so expect rough edges and changing behavior. You are granting access to a live commerce account, so be deliberate about scopes, since payments and customer data are sensitive. Treat any write or refund style action with real caution, and double-check figures against the Square dashboard before you rely on them for accounting.

Built by ContextBolt

This directory is built by ContextBolt

We build MCP-native tools that give your AI the context it cannot reach on its own. Bookmarks turns your saved posts into agent-queryable memory. SEO puts live keyword and ranking data inside Claude. Both run alongside Square in the same client.

Explore the products →

Square MCP server: FAQs

Is the Square MCP server production ready?

It is officially from Block but still in beta, so behavior and available features may change. Verify important numbers against the Square dashboard before relying on them.

What can it access?

Payments, orders, customers, and your catalog or item list, subject to the scopes you grant.

How does authentication work?

Through a Square access token (a hosted OAuth option also exists). You approve the scopes, so grant only what you need given that this touches live payment and customer data.

Do I need to be a developer to use it?

No. Merchants can ask about sales and catalog data in plain language. Developers get an extra benefit as a fast way to explore the data before building against the API directly.