Now in ChatGPT & ClaudeConnect

Connect Chatfuel MCP with Square MCP

Your clinic runs its calendar, card payments and loyalty program in Square, while customers write on WhatsApp and Instagram. Your assistant books their requests into Square Appointments, refunds a double charge and says so in the chat, and teaches the AI Agent Square's booking rules and points offers.

What the integration can do

Tools the assistant calls on each side, named as the servers name them.

Chatfuel MCP
ToolWhat it does
list_chatsLists customer chats with their channel, status and lead stage.
get_chatReturns the latest messages of one customer chat with its channel, status and lead stage.
send_chat_messageSends the text you approved to a customer in their chat and moves the chat to live chat.
return_chat_to_aiHands a chat in live chat back to the AI Agent after your yes, and the AI Agent answers the customer's last message.
get_knowledge_baseReturns what the AI Agent answers from: company info, instructions, business hours, FAQ, services and specialists.
add_faqAdds question and answer pairs to the FAQ the AI Agent answers from.
set_business_hoursReplaces the weekly business hours the AI Agent tells customers, after you confirm. Days left out are closed.
test_replySends a sample customer message to a sandbox chat and returns the AI Agent's reply.
list_postsLists recent posts and reels of the Instagram account and the Facebook Page connected to your bot.
setup_comment_repliesSets up AI or fixed replies to comments, for all of them or by keyword; on Instagram and Facebook also a DM and a choice of posts.
Square MCP
ToolWhat it does
get_service_infoLists the methods of one Square API service, such as bookings, payments or loyalty, and what each method does.
get_type_infoShows the fields a Square API method expects, so the assistant builds a valid request before calling it.
make_api_requestRuns one Square API method: reads or changes customers, bookings, payments, refunds, locations, loyalty and the rest of the API.

What to ask the assistant

Booking request in the chat → an appointment in Square Appointments

WhenA returning customer asks on Instagram for a Peeling this Saturday morning and types her phone number. Your calendar lives in Square Appointments, so the AI Agent passes the chat to your team instead of booking it in Chatfuel.

  1. Chatfuel MCP finds the chats waiting for your team with list_chats, and get_chat reads the service, the day and the phone number she typed.
  2. Square MCP's get_type_info returns the fields each call needs. make_api_request then finds her profile by that phone number and lists the free Peeling slots on Saturday morning.
  3. You pick a time, and make_api_request books it on her profile with the service, the specialist and your location.
  4. send_chat_message confirms the time in her Instagram chat after your yes to the text, and return_chat_to_ai gives the chat back to the AI Agent after another yes.

ResultThe visit appears in Square's calendar next to your other appointments, and the customer gets the time in the chat she wrote from. If no profile has her number, the assistant says so and asks before it creates one.

Ask

Hazel Sutton asked on Instagram for a Peeling this Saturday morning and typed her phone number. Find her in Square, show me the free Saturday morning times, book the one I pick and draft a confirmation for her chat.

Instagram chat in Chatfuel: the customer asks for a Saturday Peeling and types her phone, then a teammate confirms the time booked in Square

Cancellation rules and hours in Square → what the AI Agent tells customers

WhenCustomers keep asking in chats how late they can move a visit and what happens if they miss one. The answers are already in your Square Appointments settings.

  1. Square MCP reads your business booking profile with make_api_request: the 24-hour window to cancel or reschedule, the $20 no-show fee and your policy text. It also reads your location's weekly hours.
  2. Chatfuel MCP checks what the FAQ already covers with get_knowledge_base, and add_faq adds two answers: moving or cancelling a visit, and missing one.
  3. set_business_hours gives the AI Agent the same weekly hours as your Square location, once you confirm.
  4. test_reply asks the AI Agent in a sandbox chat whether tomorrow morning's visit can still be moved.

ResultChat answers match your Square settings: the same window, the same fee, the same hours. When you change the policy in Square, the AI Agent keeps the old answer until you ask the assistant to update it.

Ask

Read our cancellation window, no-show fee and opening hours from Square Appointments. Add FAQ answers on moving, cancelling and missing a visit, give the AI Agent the same hours and test what it says about moving tomorrow's appointment.

Chatfuel FAQ with two new answers from Square's settings: moving or cancelling a visit and the no-show fee

“I was charged twice” in the chat → the duplicate refunded in Square

WhenA customer writes on WhatsApp that the front desk charged her card twice for a Hydration facial today: $59 two times, card ending 4821. The AI Agent passes the chat to your team.

  1. Chatfuel MCP lists the chats waiting for your team with list_chats, and get_chat reads the amount, the day and the last four digits she gave.
  2. Square MCP lists today's payments with make_api_request, filtered by the $59 total and the card's last four digits, and finds two completed payments a minute apart.
  3. After you look at both and approve, make_api_request refunds the second one and reads back the refund status: pending or completed.
  4. send_chat_message tells her the duplicate is refunded and when to expect the money, once you approve the text. return_chat_to_ai then hands the chat back to the AI Agent.

ResultThe customer gets a confirmed refund in the same chat instead of a call back tomorrow. Square completes most refunds within a few hours, and her bank can take 7–10 business days to show the money.

Ask

Naomi Shah says on WhatsApp she was charged $59 twice today on her card ending 4821. Find both payments in Square, refund the duplicate after I confirm, and draft a reply that tells her when the money comes back.

WhatsApp chat in Chatfuel: the customer reports a double charge, and a teammate confirms the $59 refund

Double points in Square Loyalty → a DM for every POINTS comment

WhenFrom December 1 to 14, every Hydration facial earns double Nuvia Points. You announce it in an Instagram post and want each commenter to get the details in a DM.

  1. get_service_info lists Square's loyalty methods, and make_api_request reads your program: 1 point per visit, 5 points for $20 off a treatment.
  2. make_api_request creates the promotion: a 2× multiplier on the Hydration facial from December 1 to 14. Square keeps it scheduled until the first day.
  3. Chatfuel MCP finds the post with list_posts, and setup_comment_replies answers each comment with POINTS: a short public reply and a DM with the dates, the reward and an offer to book.
  4. add_faq puts the promotion in the FAQ, so the AI Agent can handle follow-up questions in the DMs.

ResultEvery commenter gets the offer in a DM, and members earn the extra points at checkout while the promotion is active. Square ties points to the customer's phone number. On TikTok a comment can't get a DM, so the public reply asks people to write first.

Ask

In Square Loyalty, double the points for the Hydration facial from December 1 to 14. Then set up replies on our latest Instagram post: comments with POINTS get a DM with the dates and the reward. Add the promotion to our FAQ too.

Chatfuel comment replies: keyword POINTS, a public reply and a DM about double points on the Hydration facial

How to connect

  1. Add Chatfuel MCP

    Connect Chatfuel from the Claude or ChatGPT directory, or give Cursor the address https://mcp.chatfuel.com/panel, and sign in with your Chatfuel account.

  2. Add Square MCP

    Claude lists Square in its directory. ChatGPT takes https://mcp.squareup.com/mcp as a custom MCP server, and Cursor reaches it through npx mcp-remote. Sign in to Square as the account owner or a teammate with full permissions.

  3. Ask in one conversation

    Square MCP has three general tools, so the assistant looks up the method and its fields before each call. Chatfuel asks for your yes before it changes the bot or writes to a customer.

  1. Connect Chatfuel from Claude's connector directory and sign in.
  2. Search the same directory for Square, made by Square, Inc., and click Connect.
  3. Sign in to Square on the page that opens and allow access. Then switch on the Square tools you need in a chat's tools menu, as Square's guide shows.
Square MCP
From Claude's directory
Chatfuel MCP in Claude

What you need

  • A Chatfuel bot with a channel connected. The double points use case also needs an Instagram account or a Facebook Page, where comment DMs go out.
  • A Square account in a country where Square takes card payments: the US, Canada, the UK, Ireland, France, Spain, Australia or Japan. The owner or a teammate with full permissions signs in.
  • Square Appointments Plus or Premium to create, move or cancel bookings through the API; on the free plan the assistant only reads them. For points, Square Loyalty with a program set up in the Square Dashboard.
  • Claude, which has Square in its connector directory; ChatGPT with developer mode for custom MCP servers; or Cursor with Node.js installed.

Limits

  • Square labels its MCP server Beta and collects feedback and bug reports as GitHub issues on square/square-mcp-server.
  • The hosted server reaches live data only. Square suggests testing prompts in a Sandbox first, and that takes the local server with a Sandbox access token.
  • Chatfuel's booking and Square Appointments keep separate calendars, and nothing syncs them. Here the assistant books in Square when you ask; bookings the AI Agent makes in Chatfuel stay in Chatfuel.
  • Seller-level access lets the assistant double-book or book outside your hours, so it checks Square's free slots first. Without Plus or Premium, Square refuses any booking change with a 403.
  • Square looks customers up by phone or email, not by name, and Chatfuel MCP shares neither. The customer has to type one in the chat; going the other way, list_chats can search for the phone on a Square profile.
  • Square documents no approval step of its own for writes such as refunds, so leave tool approval on in your assistant. Refunds work on completed payments up to a year old, at most 20 refunds per payment.
  • A reply to a customer goes out only after you approve its wording, and only inside the window: 24 hours after their last WhatsApp message, 7 days on Instagram and Messenger.
  • Square accepts only MCP clients on its allowlist. An assistant that isn't listed can't sign in until Square adds it after a request on its developer forum.

FAQ

  • Yes to both. Block hosts the server at https://mcp.squareup.com/mcp, and Square's guide at developer.squareup.com/docs/mcp calls it Beta. The local version's code is on GitHub as square/square-mcp-server. Square hasn't listed it in the MCP Registry.

Connect Chatfuel MCP

Start a free trial, add Chatfuel to your assistant and ask about Square and your chats in one place.