Square
Square provides payment processing, POS systems, invoicing, and e-commerce tools, enabling sellers to accept card payments and manage their business
Verdict
Common use cases
- Pull daily sales totals during standup
- Look up customer order history in support chat
- Check inventory levels before restocking
- Compare revenue across store locations
- Review refund trends from last quarter
Integration
- Vendor
- Square
- Category
- other
- Auth
- OAUTH2
- Composio slug
square
Tools
Setup
Setup guide
- 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find Square in the MCP directory and click Connect. 3. You'll redirect to Square's authorization page — log in with the account that owns your Square data. 4. Square asks you to approve scopes for payments (read), catalog (read), customers (read), and locations (read); grant all four to unlock the full toolset. 5. After approving, you'll return to Switchy and see Square listed as connected. 6. Open any Space, type '@Square' followed by a question like 'show me yesterday's total sales' — if the MCP responds with data, the connection works. 7. If you see an error, revisit Integrations to confirm the OAuth token is active and scopes match what the MCP expects.
What teammates see: by default, memories from Square are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Yesterday's Revenue
@Square show me total sales for yesterday, grouped by locationOpen in a Space →
Customer Lookup
@Square find the customer named Jamie Chen and list their last five ordersOpen in a Space →
Low Stock Alert
@Square list all inventory items with fewer than 10 units in stockOpen in a Space →
Refund Summary
@Square show me all refunds from the past 30 days and group them by itemOpen in a Space →
Top Sellers This Week
@Square what are the top 10 items by quantity sold this weekOpen in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Square show me today's sales broken down by payment method and location
Today's sales across your three locations total $4,287.50. Downtown processed $2,340 (55% card, 30% digital wallet, 15% cash). Westside handled $1,215 (68% card, 32% digital wallet). Market Street recorded $732.50 (all card payments). Card transactions averaged $42 per sale, while digital wallet averaged $28. This data reflects transactions posted as of 2:15 PM local time.
This example shows the MCP retrieving transaction data and the AI synthesizing it into a comparative summary. Requires OAuth scope for reading payments and locations. Real-time data may lag 5–15 minutes depending on Square's sync cadence. Sales figures are illustrative.
@Square create a new catalog item: 'Holiday Gift Box' priced at $45, available at all locations, track inventory
Created catalog item 'Holiday Gift Box' with SKU HGB-2024. Price set to $45.00. Item is now live across Downtown, Westside, and Market Street locations. Inventory tracking enabled — current stock set to zero at all locations. You can update quantities through Square Dashboard or ask me to adjust stock levels. Item ID: cat_7x9k2mP4qR.
Demonstrates the MCP's ability to write data back to Square's catalog. Requires OAuth scope for catalog management. Creating items with inventory tracking means you must set initial stock counts separately. The item goes live immediately — no staging or approval step.
@Square pull the last 30 days of customer feedback from digital receipts and summarize common themes
Analyzed 142 customer comments from digital receipts over the past 30 days. Three themes emerged: 18% mentioned fast checkout (positive), 12% requested more vegan options (product request), 9% noted parking difficulty at the Downtown location (operational concern). Average receipt rating: 4.6/5. Most feedback came from repeat customers (68%). No critical complaints flagged. Raw comment data available if you need specifics.
This example pairs the MCP's data retrieval with the AI's text analysis capabilities. Requires OAuth scope for reading customer data and receipts. Not all Square accounts collect receipt feedback — availability depends on your receipt settings. Percentages are illustrative based on typical comment volumes.
Use-case deep-dives
When Square MCP makes sense for weekly sales reconciliation
A 6-person retail operations team runs three storefronts and needs to pull transaction data into their weekly ops review. The Square MCP can surface daily sales totals, refund counts, and inventory movement without exporting CSVs. OAuth2 auth means each team member connects their own Square account once, then queries live data in Switchy threads. This works if your review cadence is weekly or slower—real-time dashboards belong in Square's native analytics. The buying call: if you're copy-pasting Square reports into Slack or Notion today, the MCP saves 20 minutes per review cycle and keeps the data fresh.
Square MCP for support teams handling payment disputes
A 4-person customer support team at a subscription box company fields 15-20 refund requests per week. The Square MCP lets support reps look up transaction details, check payment method on file, and verify refund eligibility without switching to the Square dashboard. OAuth2 means each rep authenticates once, then queries payment history inline during ticket resolution. This breaks down if your refund volume exceeds 50 per day—at that scale, you need a dedicated fraud or billing ops role with direct dashboard access. The call: if your support team spends more than 10 minutes per week context-switching to Square, the MCP pays for itself in saved clicks.
When solo operators should skip the Square MCP
A solo consultant invoices 8-12 clients per month through Square and wants to automate invoice tracking in Switchy. The Square MCP can pull invoice status and payment dates, but the setup overhead (OAuth flow, learning the tool syntax, maintaining the connection) outweighs the benefit at this volume. You're better off using Square's native email notifications or a Zapier bridge to your task manager. The MCP makes sense when you cross 30 invoices per month or when multiple team members need shared access to payment data. The call: if you're a one-person shop, wait until you hire your first ops person before adding this integration.
Frequently asked
What does the Square MCP do in Switchy?
The Square MCP connects your Square account to Switchy's AI workspace, letting your team query transaction data, customer records, and inventory without logging into the Square dashboard. Your AI agents can pull sales reports, look up order details, and answer questions about your point-of-sale data in natural language.
Do I need admin access to connect Square via OAuth?
Yes. Square's OAuth flow requires you to authorise with an account that has owner or admin permissions on your Square location. The MCP will request read access to your sales, customers, and inventory — you'll see the exact scope list during the OAuth consent screen before you approve.
Can the Square MCP process refunds or update inventory?
Not yet. The current integration is read-only, so your team can query data but can't modify transactions, issue refunds, or adjust stock levels through Switchy. If you need write access, use Square's native dashboard or API directly until we add those capabilities.
How is this different from just logging into Square?
The MCP lets your whole team ask questions about Square data in plain English without learning Square's interface or running manual reports. Instead of five people logging in separately to pull the same sales figures, one connection gives everyone instant answers inside Switchy's shared workspace.
Who on my team should connect the Square account?
Whoever owns your Square account or has admin rights. Once connected, everyone in your Switchy workspace can query the data through AI agents — they don't need individual Square logins. The connection counts as one integration against your Switchy plan limit.