home / mcp / square mcp server

Square MCP Server

Provides access to Square API functionality via an MCP server to perform actions and fetch data.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "block-square-mcp": {
      "command": "square-mcp",
      "args": [],
      "env": {
        "SQUARE_ENVIRONMENT": "sandbox",
        "SQUARE_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN"
      }
    }
  }
}

You run an MCP server that exposes Square API functionality to clients through a consistent MCP interface. You can connect your MCP client to this server, supply your Square access token, and choose the environment (sandbox or production) to perform API interactions in a controlled way.

How to use

To use this MCP server, first set up your environment variables with your Square access token and environment. Then start the server so your MCP client can connect and issue requests through the MCP interface.

How to install

Prerequisites: you need the MCP runtime tool available as a command named uv and Python tooling if you follow the development path.

Steps to run the server in normal mode

uv sync
export SQUARE_ACCESS_TOKEN=your_access_token_here
export SQUARE_ENVIRONMENT=sandbox  # or 'production'

uv pip install .
square-mcp

Development run (advanced)

source .venv/bin/activate
mcp dev src/square_mcp/server.py

Environment variables

You must provide your Square API access token and optionally the environment for API calls.

Notes and practical tips

- The environment variable SQUARE_ACCESS_TOKEN is required to authorize requests to the Square API. - If you do not set SQUARE_ENVIRONMENT, it defaults to sandbox unless you specify production.