Skip to main content
Glama

Square Model Context Protocol Server

Official
by square

Square Model Context Protocol Server (Beta)

This project follows the Model Context Protocol standard, allowing AI assistants to interact with Square's connect API.

Quick Start

Get up and running with the Square MCP server using npx:

# Basic startup npx square-mcp-server start # With environment configuration ACCESS_TOKEN=YOUR_SQUARE_ACCESS_TOKEN SANDBOX=true npx square-mcp-server start # local runs npx /path/to/project/square-mcp-server

Replace YOUR_SQUARE_ACCESS_TOKEN with your actual Square access token. You can obtain your access token by following the guide at Square Access Tokens. You can also set environment variables before running the command.

Remote MCP Server

Square now offers a hosted remote MCP server at:

https://mcp.squareup.com/sse

The remote MCP is recommended as it uses OAuth authentication, allowing you to log in with your Square account directly without having to create or manage access tokens manually.

Configuration Options

Environment Variable

Purpose

Example

ACCESS_TOKEN

Your Square API access token

ACCESS_TOKEN=sq0atp-...

SANDBOX

Use Square sandbox environment

SANDBOX=true

PRODUCTION

Use Square production environment

PRODUCTION=true

DISALLOW_WRITES

Restrict to read-only operations

DISALLOW_WRITES=true

SQUARE_VERSION

Specify Square API version

SQUARE_VERSION=2025-04-16

Integration with AI Assistants

Goose Integration

To configure the Square MCP Server with Goose:

Remote MCP

To install the Square remote MCP in Goose, click this URL on a computer where Goose is installed:

goose://extension?cmd=npx&arg=mcp-remote&arg=https%3A%2F%2Fmcp.squareup.com%2Fsse&id=square_mcp_production_remote&name=Square%20MCP%20Remote&description=Square%20Production%20MCP%20Remote

Or copy and paste the URL into your browser's address bar.

# Automatic installation npx square-mcp-server install # Get URL for manual installation npx square-mcp-server get-goose-url

The install command automatically updates your Goose configuration.

Claude Desktop Integration

For Claude Desktop integration, see the Model Context Protocol Quickstart Guide. Add this configuration to your claude_desktop_config.json:

Remote MCP

{ "mcpServers": { "mcp_square_api": { "command": "npx", "args": ["mcp-remote", "https://mcp.squareup.com/sse"] } } }

This approach allows you to authenticate directly with your Square account credentials without needing to manage access tokens.

Local MCP

{ "mcpServers": { "mcp_square_api": { "command": "npx", "args": ["square-mcp-server", "start"], "env": { "ACCESS_TOKEN": "YOUR_SQUARE_ACCESS_TOKEN", "SANDBOX": "true" } } } }

Tool Reference

The Square MCP Server provides a streamlined set of tools for interacting with Square APIs:

Tool

Description

Primary Use

get_service_info

Discover methods available for a service

Exploration and discovery

get_type_info

Get detailed parameter requirements

Request preparation

make_api_request

Execute API calls to Square

Performing operations

Service Catalog

Square MCP Server provides access to Square's complete API ecosystem. Check out the Square API Documentation for detailed information about each service:

Service

Description

applepay

Apple Pay integration

bankaccounts

Bank account management

bookingcustomattributes

Custom attributes for bookings

bookings

Appointment booking management

cards

Payment card management

cashdrawers

Cash drawer management

catalog

Catalog management (items, categories, etc.)

checkout

Checkout and payment processing

customercustomattributes

Custom attributes for customers

customergroups

Customer grouping

customersegments

Customer segmentation

customers

Customer management

devices

Square device management

disputes

Payment dispute handling

events

Event tracking

giftcardactivities

Gift card activity tracking

giftcards

Gift card management

inventory

Inventory tracking

invoices

Invoice management

labor

Workforce management

locationcustomattributes

Custom attributes for locations

locations

Location management

loyalty

Loyalty program management

merchantcustomattributes

Custom attributes for merchants

merchants

Merchant account management

oauth

Authentication

ordercustomattributes

Custom attributes for orders

orders

Order management

payments

Payment processing

payouts

Payout management

refunds

Refund management

sites

Website integration

snippets

Square Online Code integration

subscriptions

Subscription management

team

Staff management

terminal

Square Terminal management

vendors

Supplier management

webhooksubscriptions

Event notifications

Usage Pattern

For optimal interaction with the Square API through MCP:

  1. Discover: Use get_service_info to explore available methods

    get_service_info(service: "catalog")
  2. Understand: Use get_type_info to learn parameter requirements

    get_type_info(service: "catalog", method: "list")
  3. Execute: Use make_api_request to perform the operation

    make_api_request(service: "catalog", method: "list", request: {})

Development and Debugging

Using MCP Inspector

The MCP Inspector provides a visual interface for testing:

# Build the project npm run build # Start the inspector with the Square MCP Server npx @modelcontextprotocol/inspector node dist/index.js start

Development Workflow

  1. Clone the repository

  2. Install dependencies: npm install

  3. Start development mode: npm run watch

  4. Run the server: node dist/index.js start

  5. Test your changes using the MCP Inspector

Contributing

This repository is auto-generated from Square's OpenAPI Specification. While contributions are welcome, please note that changes will need to be incorporated into the generator that produces this code. Please open an issue to discuss proposed changes before submitting a pull request.

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables AI assistants to interact with Square's Connect API through the Model Context Protocol standard, allowing for operations like managing customers, processing payments, and handling inventory.

  1. Quick Start
    1. Remote MCP Server
      1. Configuration Options
        1. Integration with AI Assistants
          1. Goose Integration
          2. Claude Desktop Integration
        2. Tool Reference
          1. Service Catalog
            1. Usage Pattern
              1. Development and Debugging
                1. Using MCP Inspector
                2. Development Workflow
              2. Contributing

                Related MCP Servers

                • A
                  security
                  F
                  license
                  A
                  quality
                  Implements the Model Context Protocol to allow AI models to access and interact with blockchain data, including reading contract states, retrieving events, and accessing transaction information across various networks.
                  Last updated -
                  10
                  22
                  67
                • -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.
                  Last updated -
                  7
                  3
                • -
                  security
                  F
                  license
                  -
                  quality
                  Enables AI models to interact with Linear for issue tracking and project management through the Model Context Protocol, supporting capabilities like creating issues, searching, managing sprints, and bulk updating statuses.
                  Last updated -
                  5
                • -
                  security
                  A
                  license
                  -
                  quality
                  Enables AI assistants to interact with Slack workspaces through the Model Context Protocol, providing tools for reading/sending messages, managing channels, and accessing Slack API functionality.

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/square/square-mcp-server'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server