Goldie MCP Server
Appointments, clients, services, payments and mass messages in Goldie.
Servidor MCP hospedado
npx add-mcp 'https://cotlet.dev/mcp/v1/goldie'Instala no Claude Code, Codex, Cursor e outros
Documentação
Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up
Goldie API and MCP server: Let your AI agent run the front desk of your chair.
Goldie publishes no public API. Its website, Help Center and LLM information page show no developer documentation, and no Goldie MCP server or official ChatGPT or Claude connector was verified.
Goldie publishes no public API and no MCP server (checked 14 Nov 2026). Cotlet runs a hosted Goldie MCP server with 9 tools that ChatGPT and Claude use in your own Goldie account. Bookings, charges, refunds and messages wait for your OK before they reach a client.
- Free 7-day trial, no card
- Unofficial, not affiliated with Goldie
- Page: https://cotlet.dev/integrations/goldie-api-mcp-server
What can your AI agent do in Goldie?
- Book a client into the right slot
- Move an appointment to another day
- Take a deposit or the balance
- Refund all or part of a payment
- Add a service and open it online
- Offer quiet slots to your clients
Does Goldie have an MCP server or an API?
- The Goldie Help Center writes its steps for the Goldie app on iOS and Android; the web app signs in at app.heygoldie.com.
- Export Data in Goldie emails a ZIP file of clients, appointments, services and account data, the one built-in way to take data out.
- Mass messages are for the Pro and Pro Plus plans, and Goldie's own messaging system is offered in certain countries.
| What you need | Goldie app by hand | Data export | Cotlet |
|---|---|---|---|
| Ask ChatGPT or Claude to do the work | Copy and paste | A ZIP file by email | Hosted MCP server |
| Book, reschedule and take payments | One tap at a time | Read only | 9 tools, writes after your OK |
| Refund part of a payment | From the appointment | Not possible | refund_client_payment |
| Run from n8n or a script | Manual only | Parse the files yourself | REST, same key |
Checked 14 Nov 2026. Sources: Goldie website, Goldie Help Center, Goldie LLM information page, Goldie pricing, Help: How do I create an appointment?, Help: Can I reschedule an appointment for another day?, Help: How do I create a new client?, Help: How do I create services?, Help: How do I activate online booking?, Help: How do I take payments from a client?, Help: How do I refund a payment to my client?, Help: Can I send a mass/bulk message to all my clients?, Help: How do I export my Goldie data?
How does the Goldie MCP server work?
- Sign in to Goldie. Once, in a browser we host for you.
- Connect your AI agent. One address in its settings.
- Hand it the bookings. Book a client, then approve the deposit.
Cotlet never sees or stores your password. Writes, and anything that reaches a client or moves money, wait for your OK.
How to connect Goldie to your AI agent
- Sign in to Goldie in a Cloud Browser. Open app.heygoldie.com in your Cotlet Cloud Browser and sign in with your own Goldie account.
- Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
- Let the agent in. Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.
Goldie shares the address https://cotlet.dev/mcp/v1 with every other app you turn on, so one connector covers them all. Turned Goldie on after connecting? Refresh the connector and the 9 Goldie tools appear.
ChatGPT:
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
Claude:
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect
Claude Code:
claude mcp add --transport http cotlet \
https://cotlet.dev/mcp/v1 \
--header "Authorization: Bearer $COTLET_API_KEY"
Cursor:
// ~/.cursor/mcp.json
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
}
Codex:
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
n8n:
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: manage_appointments
All 9 Goldie MCP tools
One tool per owner workflow in the Goldie Help Center. Several take an action: list, get and history only read, the other actions write and ask first.
Calendar and appointments
Read the day, book a client and move a visit. Goldie tells the client when an appointment moves.
- Create appointments (
manage_appointments, write, asks first): Read your Goldie calendar for a day, or create an appointment. - Reschedule appointments (
reschedule_appointment, write, asks first): Move a Goldie appointment to another day or time.
Clients, services and online booking
The records a booking points at, and the switch that opens your booking site.
- Add clients (
manage_clients, write, asks first): List or open your Goldie clients, or add a new one. - Create services (
manage_services, write, asks first): List your Goldie services, add one or change its price, duration or online booking. - Turn online booking on or off (
set_online_booking, write, asks first): Read or switch Goldie's "Let customers book online" setting.
Checkout and refunds
Deposits, full payments and refunds, in full or in part. Your Goldie user needs the matching permission.
- Take deposits and payments (
take_client_payment, write, asks first): Take a deposit or the full payment for an appointment at Goldie checkout. - Refund client payments (
refund_client_payment, write, asks first): List an appointment's transactions or refund one in full or in part.
Messages and your data
Mass messages for Pro and Pro Plus, and the export Goldie emails to you.
- Send mass messages (
send_mass_message, write, asks first): Read your mass message history or send a message to a group of clients. - Export Goldie data (
export_goldie_data, read): Ask Goldie to email you an export of your clients, appointments, services and account data.
Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/goldie-api-mcp-server#tools
Who can see my Goldie session, and how do I revoke it?
- What we store. Your signed-in Goldie browser profile, AES-256-GCM encrypted, in Finland. Never your password.
- What your agent gets. The 9 Goldie tools. The session cookie stays in the Cloud Browser.
- What the session sees. The calendar, clients and payments your Goldie user can open. Payments and refunds also need those permissions on your user.
- What no tool touches. Your Goldie plan, team members, payment processing setup, no-show protection rules and the sending device on your phone.
- If Goldie signs you out. You sign in again yourself, in the same Cloud Browser.
- How to cut access. Turn Goldie off for agents, reset the browser, or change your Goldie password.
Cotlet never sees or stores your password. You type it into Goldie yourself, and the agent only uses the session that sign-in leaves behind. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).
What happens when Goldie changes?
Cotlet watches the apps it serves and updates the Goldie server when Goldie changes its screens, so your agent keeps booking without a change on your side.
Some Goldie features depend on your plan or country, such as mass messages through Goldie's system. The agent works with what your account shows and tells you when a screen is missing.
If Goldie signs you out, one click in the Cotlet console reopens the Cloud Browser so you can sign in again.
Approvals, undo and mistakes
- Find the payment. refund_client_payment lists the transactions.
- Check what is left. The amount still available to refund.
- Show you the refund. Amount, client and method, before anything moves.
- Refund after your OK. Goldie returns the money to the client.
| Action | How to put it right |
|---|---|
| Service details, online booking switch | Call manage_services or set_online_booking again with the earlier values |
| Appointment moved to the wrong day | Move it back with reschedule_appointment; Goldie tells the client again |
| Payment taken twice | Refund the extra with refund_client_payment |
| Mass message | Already with your clients: send a correction |
All 8 write tools ask first: by default you confirm each call, and you can switch that off per tool. The read tool, export_goldie_data, runs at once and changes nothing in Goldie.
MCP call:
{
"name": "refund_client_payment",
"arguments": {
"action": "refund",
"appointment": "Example Client B, 2026-11-18",
"amount": 20,
"method": "card"
}
}
REST:
curl -X POST https://cotlet.dev/api/v1/goldie/client-payment/refund \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"action":"refund","appointment":"Example Client B, 2026-11-18","amount":20,"method":"card"}'
Response:
{
"client": "Example Client B",
"transaction": "Brow lamination, card",
"amount": 20,
"available_after": 40,
"method": "card",
"refunded": true
}
The example refunds $20 of a $60 card payment and leaves $40 that can still be refunded later, as Goldie allows. A cron job or n8n flow can make the same call over REST at /api/v1/goldie with the same key and price, in JSON. Failed calls are free.
How much does the Goldie MCP server cost?
About $24 a month for a one-chair studio with about 40 bookings a month, 4,070 credits. Your Goldie plan stays as it is.
| Job | Calls | Credits |
|---|---|---|
| Morning look at the day's calendar | 1 × 24 | 240 |
| New bookings, client and service lookup | 3 × 40 | 1,200 |
| Reschedules | 2 × 15 | 300 |
| Deposits and payments at checkout | 1 × 60 | 600 |
| Partial refunds | 2 × 3 | 60 |
| Service and price changes | 2 × 4 | 80 |
| Weekly quiet-day offer | 2 × 4 | 80 |
| Monthly data export | 1 × 1 | 10 |
| Cloud Browser, 30 days | 1,500 | |
| Total | 257 calls | 4,070 |
The smallest pack, 5,000 credits for $29, covers this month with room left. A busier salon with more chairs uses more calls.
- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- Your Goldie plan and payment fees apply as they are
Credit packs are one-time purchases, not a subscription. The month above is an example built from our own assumptions, not measured customer usage.
Goldie MCP server: other ways to connect
| Option | What it does | Where it stops |
|---|---|---|
| The Goldie app | Everything on this page, by hand on iOS, Android or the web. | One tap at a time, only while you hold the phone. |
| Goldie data export | A ZIP file of clients, appointments, services and account data by email. | A copy to read; it books, charges and messages nothing. |
| Goldie data import | Goldie's team imports clients, services and future appointments from CSV or Excel files. | A one-time move when you switch systems. |
If you only need a copy of your data, Goldie's own export is free and enough. Cotlet fits when you want ChatGPT, Claude or a script to book, take payments and message clients in Goldie, from your own login, with nothing to host.
Who runs Cotlet
Cotlet is run by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and in business since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev with questions about the Goldie tools.
Goldie MCP server: questions
How do I get access?
Sign up free at https://cotlet.dev/signup?app=goldie, turn on Goldie under Integrations in the console and sign in at https://app.heygoldie.com/ in your Cloud Browser. Then connect your AI agent and ask it about today's calendar. The trial needs no card.
Does Goldie have an API?
Goldie publishes no public API (checked 14 Nov 2026). Its website, Help Center and LLM information page show no developer documentation, and no Goldie MCP server or official ChatGPT or Claude connector was verified. Cotlet does not need one: it works in your own signed-in Goldie account.
Which Goldie plan do I need for mass messages?
Goldie's Help Center says mass messages are for its Pro and Pro Plus plans, under Menu, Marketing, Mass Message. send_mass_message works only where your plan shows that screen.
Can the agent refund only part of a payment?
Yes. Goldie lets you refund part of a transaction, from the appointment or the Payments dashboard, and refund again later until nothing is left. Your user needs permission to issue refunds, and Goldie Payments must be active.
Which Goldie user should I sign in with?
The one whose work the agent should do. Taking payments and issuing refunds need those permissions on that user, and on Pro Plus only the Account Owner can export data.
Is the MCP server different from the REST API?
Only in how it is called. Both carry the same 9 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.
Is Cotlet affiliated with Goldie?
No. Cotlet is independent and not affiliated with Goldie.
Give your AI agents your signed-in browser.
Product: Integrations · How it works · Pricing · Security
Resources: Blog · API docs · Help center · Changelog · GitHub
Solutions: For developers · For automation agencies
Company: About · AI info: company facts · Contact
Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors
Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub
Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us
Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.