Toast does not publish an MCP server. (But Square does, FYI.) So for Toast, the connection between Claude and your POS is community code, and the one I run is at github.com/prime-cost/toast-mcp. It is free, read-only, and it runs against both of my restaurants every day.
My test for all of this: does it cut friction? Does it increase speed? Toast already shows me sales and punches. The work is getting those numbers next to everything else without moving them by hand, and then automating it.
Less friction. Faster decisions.
Staffing: sales history is in Toast, the schedule is in another tool. With both connected to Claude, it does the comparison and shows me what needs a look. A slow Tuesday: Toast and the email tool connected, Claude drafts the promotion for that night. Fewer steps between spotting the problem and doing something about it.
This server is the Toast half. Fifty-five read-only tools for sales, labor and orders. Connect your other tools to the same Claude and it works across them. Put it on a schedule and it runs before you sit down. That is the morning email below.
The Toast server is read-only by default. Twenty-one additional tools could create orders, refund payments, void checks, or edit employees, but they ship disabled. Leave them that way.
What you need before you start
Standard API access from Toast. A client ID and client secret from the Manage credentials page in Toast Web. How to get it, and which program to ask for.
Your restaurant GUID. Toast's confirmation email lists it for every location you selected.
A place to run the server. Railway is about $5 a month and takes one click.
A Claude plan with custom connectors.
Set it up in four steps
Get the API credentials from Toast, per the post above.
Go to railway.com/deploy/toast-mcp, click Deploy Now, and paste three values: client ID, client secret, restaurant GUID. The connector password generates itself. Copy it from the Variables tab and save it.
In Railway, Settings, then Networking, then Generate Domain. Open your domain plus
/healthin a browser. You want{"status":"ok"}.In claude.ai, Settings, then Connectors, then Add custom connector. Name it Toast. The URL is your domain, then your secret, then
/mcp.
Open a new chat and ask what your net sales were last night. Because the server is what's connected, it works everywhere you sign into Claude, including the phone.
Every click, with the screens, is in I connected Claude to my Toast POS.
It runs every morning without me
Every morning a scheduled task in Claude's cloud pulls yesterday's sales, labor, time entries, hourly sales and item sales through this server and emails one report per store. Nothing on my laptop has to be on.
The email is what I'd pull by hand if I had an hour: net sales, tips, labor, comps, the punches that need fixing, the hourly curve, item movers against a four-week baseline, the same day last year, and the manager's notes.
Why it works when the original didn't
The code began as someone else's repo. It had never completed a live call to Toast: the authentication response was read wrong, so every request failed. I fixed that against my own stores, then the list endpoints, the restaurant scoping headers, the labor report, the item sales report and the discount report. Every number now matches my manager logs, and a twelve-check test runs against a live account before each release.
As far as I can tell, this is the first Toast MCP server that has ever run against a real restaurant.
Read-only, and the secret is the only lock
The server runs on your Railway account and talks to one outside host: Toast's API. Your credentials never pass through me or anyone else. The connector URL contains your secret, so never screenshot it. If it leaks, rotate the secret in Railway and update the URL in Claude. Two minutes.
Square, Clover, and everything else
If you are on Square, use Square's own MCP server. It is official and hosted, and there is nothing to run.
Clover, SpotOn, Lightspeed and the rest have no working connector I know of. The offer to build one with an operator who runs it is here.
Everything I've written about Toast is at chriscusack.net/t/toast.
Toast MCP questions
What is a Toast MCP server?
A small program that lets an AI assistant read your Toast POS data through Toast's API. MCP is the open standard Claude, ChatGPT and Cursor use to talk to outside systems. The server sits between the assistant and Toast and translates questions into API calls.
Does Toast have an official MCP server?
No. Square publishes one. For Toast, the connectors are community code. Mine is at github.com/prime-cost/toast-mcp and is the one I run in two restaurants.
Can Claude run Toast reports on a schedule?
Yes. My morning report pulls sales, labor, time entries, hourly sales and item sales through this server on a schedule and emails one report per store. It runs in the cloud, and no one is at the keyboard.
Is it safe to connect Claude to Toast?
The server is read-only by default. The twenty-one tools that could change anything in Toast ship disabled. It runs on your own Railway account, talks only to Toast, and the connector secret is the single lock, so keep it off screenshots.
Does it work with ChatGPT?
The connection is built on MCP, and ChatGPT and Cursor speak it. I built and tested mine with Claude, so that is the path I can vouch for.