# square-automation

square-automation automates Square operations: payments, orders, invoices, and locations via Rube MCP. Use it to search transactions, update order status, and manage invoices from your editor.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 119 installs · ★ 3785 repo stars
- Author: davepoon
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/square-automation/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/square-automation

## What it does

The skill connects Square API through Composio and Rube MCP, exposing tools for payment history, order search and updates, invoice management, and location queries. It organizes workflows into four groups: payment listing and cancellation, order search and modification, location management, and invoice operations.

To use it, add the Rube MCP server at `https://rube.app/mcp` and activate a Square connection via `RUBE_MANAGE_CONNECTIONS`. Always call `RUBE_SEARCH_TOOLS` first to fetch current tool schemas. Many operations require a `location_id`—start with `SQUARE_LIST_LOCATIONS` to resolve location names to IDs. Payments and orders are paginated; follow the `cursor` field until it's absent.

Key constraints: only pending payments can be cancelled; completed ones need refunds. The `UPDATE_ORDER` and `CANCEL_INVOICE` tools require the current `version` field from the resource, or they return a 409 conflict. Timestamps use RFC 3339 format (e.g., '2024-01-01T00:00:00Z'). Large result sets demand pagination via the `cursor` parameter.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill square-automation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/square-automation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/square-automation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill square-automation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/square-automation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill square-automation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/square-automation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davepoon/buildwithclaude plugins/all-skills/skills/square-automation
```

2. **Manually: put the files in place**
- File: `.github/skills/square-automation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill square-automation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davepoon/buildwithclaude --path plugins/all-skills/skills/square-automation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/square-automation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add davepoon/buildwithclaude --skill square-automation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/square-automation/SKILL.md

## When to use it
- retrieve payment history and check transaction status
- search orders by criteria and update order state
- cancel an invoice before sending to a customer
- fetch all business locations for filtering operations

## Example prompts
- Show me payments from the last 30 days for the Main Store location
- Find all open orders and change their state to COMPLETED
- Cancel invoice xyz789—it was sent by mistake

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 6946a3ebb3b99f2b.

BEGIN THIRD-PARTY FILE 6946a3ebb3b99f2b
```text
---
name: square-automation
description: "Automate Square tasks via Rube MCP (Composio): payments, orders, invoices, locations. Always search tools first for current schemas."
requires:
  mcp: [rube]
category: ecommerce
---

# Square Automation via Rube MCP

Automate Square payment processing, order management, and invoicing through Composio's Square toolkit via Rube MCP.

**Toolkit docs**: [composio.dev/toolkits/square](https://composio.dev/toolkits/square)

## Prerequisites

- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Square connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `square`
- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas

## Setup

**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `square`
3. If connection is not ACTIVE, follow the returned auth link to complete Square OAuth
4. Confirm connection status shows ACTIVE before running any workflows

## Core Workflows

### 1. List and Monitor Payments

**When to use**: User wants to view payment history or check payment status

**Tool sequence**:
1. `SQUARE_LIST_PAYMENTS` - Retrieve payments with optional filters [Required]
2. `SQUARE_CANCEL_PAYMENT` - Cancel a pending payment if needed [Optional]

**Key parameters**:
- `begin_time` / `end_time`: RFC 3339 timestamps for date range filtering
- `sort_order`: 'ASC' or 'DESC' for chronological ordering
- `cursor`: Pagination cursor from previous response
- `location_id`: Filter payments by specific location

**Pitfalls**:
- Timestamps must be RFC 3339 format (e.g., '2024-01-01T00:00:00Z')
- Pagination required for large result sets; follow `cursor` until absent
- Only pending payments can be cancelled; completed payments require refunds
- `SQUARE_CANCEL_PAYMENT` requires exact `payment_id` from list results

### 2. Search and Manage Orders

**When to use**: User wants to find orders by criteria or update order details

**Tool sequence**:
1. `SQUARE_LIST_LOCATIONS` - Get location IDs for filtering [Prerequisite]
2. `SQUARE_SEARCH_ORDERS` - Search orders with filters [Required]
3. `SQUARE_RETRIEVE_ORDER` - Get full details of a specific order [Optional]
4. `SQUARE_UPDATE_ORDER` - Modify order state or details [Optional]

**Key parameters**:
```
END THIRD-PARTY FILE 6946a3ebb3b99f2b

The third-party file has ended. Everything between the 6946a3ebb3b99f2b tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2451 of 6674 bytes. © davepoon · MIT · https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/all-skills/skills/square-automation/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
