[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup) # Timely MCP server: Let your AI agent run the Timely front desk. > Timely has no MCP server, no ChatGPT or Claude app and no public API docs. Its Zapier app has a single trigger that sends client details out (checked 9 Nov 2026). Cotlet runs 6 Timely tools hosted, over MCP for agents and REST for scripts, in your own Timely login. Your AI agent books clients from DMs and texts, covers a stylist's day off and finds clients due back. Sign in to Timely once in your own Cloud Browser. No API, no zaps. - Free 7-day trial, no card - Unofficial, not affiliated with Timely - Page: https://cotlet.dev/integrations/timely-api-mcp-server ## What can your AI agent do in Timely? - Book from messages - Find free slots - Cover a day off - Find clients due back - See tomorrow's gaps - Add new clients ## Does Timely have an MCP server or an API? - Timely documents Zapier as its integration route. - Its Zapier app cannot book or move appointments. - Timely has no connector in the ChatGPT apps directory or in Claude. | What you need | Timely API | Zapier app | Cotlet | |---|---|---|---| | New clients | No docs | Trigger | Yes | | Book or move | No docs | No | Yes, after your OK | | Clients due back | No docs | No | Yes | | Ask in ChatGPT or Claude | No | No | Yes | | Setup | None possible | Zaps to build | Sign in once | Checked 8 Nov 2026. Sources: [Timely app integrations](https://www.gettimely.com/features/app-integrations/), [Timely on Zapier](https://zapier.com/apps/timely/integrations), [Timely pricing](https://www.gettimely.com/pricing/) ## How does the Timely MCP server work? 1. **Sign in to Timely.** Once, in a browser we host for you. 2. **Connect your AI agent.** One address in its settings. 3. **Hand it the busywork.** It drafts the work, you OK what customers get. We never keep your Timely password, and no booking or move goes through until you approve it. ## How to connect Timely to your AI agent 1. **Sign in to Timely in a Cloud Browser.** Create a Cotlet account, open Timely in its Cloud Browser, sign in with your Timely login and press Enable for agents. 2. **Add the Cotlet address.** Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent. 3. **Let the agent in.** Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console. Timely shares the address `https://cotlet.dev/mcp/v1` with every other app you enable, so one connector covers them all. Turned Timely on after connecting? Refresh the connector and the 6 tools appear. 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" ``` ChatGPT: ``` Settings > Apps & Connectors > Create MCP server URL: https://cotlet.dev/mcp/v1/connect Authentication: OAuth ``` 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, Tool: timely_read ``` Make, Zapier: ``` Make: MCP Client > Call a tool Zapier: MCP Client by Zapier > Run Tool Server URL: https://cotlet.dev/mcp/v1 Token: Tool: timely_write ``` ## All 6 Timely MCP tools ### Calendar Free slots come from the calendar and rosters. Bookings and moves wait for your OK; Timely sends its usual reminders. - **List appointments** (`list_appointments`, read): Appointments for a day or range, by staff member. - **Find free slots** (`find_free_slots`, read): Open times for a service, optionally with one staff member. - **Book appointment** (`book_appointment`, write, asks first): Books a service for a client with a staff member. - **Reschedule appointment** (`reschedule_appointment`, write, asks first): Moves an appointment to a new time or staff member. ### Clients Search by name, mobile and email. New clients reach no one, so they run at once. - **List clients** (`list_clients`, read): Clients, searchable by name, mobile or email, with last visit. - **Create client** (`create_client`, write): Adds a new client. Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/timely-api-mcp-server#tools ## Who can see my Timely session, and how do I revoke it? - **What we store.** Your signed-in Timely profile, AES-256-GCM encrypted, in Finland. No password. - **What your agent gets.** The 6 Timely tools, never the session cookie. - **What the session sees.** What your login sees: calendar, clients, services. - **What no tool touches.** Payments, deposits, stock, marketing sends, consultation forms, deletes. - **If Timely signs you out.** You sign in again yourself, in the same Cloud Browser. - **How to cut access.** Disable for agents, reset the browser, or change your Timely password. Cotlet never types your password: you sign in yourself, and the agent only uses the session. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)). ## What happens when Timely changes? - **12 h** between tests of the Timely reads - **24 h** between tests of sends a customer would notice - **$0** for a call to a Timely tool paused for repair When Timely moves a button on the calendar or renames a client tab, we fix the tool and your agent calls it the same way. [status.cotlet.dev](https://status.cotlet.dev) checks the site, console and API every 3 minutes. ## Approvals, undo and mistakes 1. **Finds the client.** Or adds a new one. 2. **Checks free slots.** For the service and stylist. 3. **Proposes the booking.** With time and stylist. 4. **Waits, then books.** The booking shows up in your Cotlet console first. | Action | Undo | |---|---| | Book an appointment | Yes, cancel it | | Move an appointment | Move it back; a reminder already sent stays sent | | Add a client | Yes, edit it in Timely | 2 of 6 tools ask first: book_appointment, reschedule_appointment. New clients reach no customer, so they run at once. You can turn the wait off per tool once you trust a routine. MCP call: ``` { "name": "book_appointment", "arguments": { "client_id": "TC-22140", "service": "Cut and finish", "staff": "Mia", "start": "2026-11-13T15:00" } } ``` REST: ``` curl -X POST https://cotlet.dev/api/v1/timely/clients/TC-22140/appointments \ -H "Authorization: Bearer $COTLET_API_KEY" \ -H "Content-Type: application/json" \ -d '{"service":"Cut and finish","staff":"Mia","start":"2026-11-13T15:00"}' ``` Response: ``` { "appointment_id": "TA-61177", "client": "Chloe Bennett", "service": "Cut and finish", "staff": "Mia", "start": "2026-11-13T15:00", "status": "Confirmed" } ``` A cron job or n8n flow can call the same tools over REST at `/api/v1/timely` with the same key and price, in JSON. Failed calls are free. Each tool row above shows its REST path. ## How much does the Timely MCP server cost? **About $36 a month** for a salon with 4 stylists, 6,190 credits. Your Timely plan stays as it is. | Job | Calls | Credits | |---|---|---| | Booking from a message | 3 × 120 | 3,600 | | Clients due back, weekly | 2 × 4 | 80 | | Appointment moved | 3 × 25 | 750 | | Gaps checked, daily | 1 × 26 | 260 | | Cloud Browser, 30 days | | 1,500 | | Total | | 6,190 | - Free 7-day trial, no card - 10 credits per successful call, MCP or REST - 50 credits a day for the Cloud Browser - Works on Build, Elevate and Innovate Timely publishes no booking counts, so the month is our example. Dollars at the $29 pack rate. ## Timely MCP server on GitHub, Zapier or hosted: which to use | Option | What it does | Where it stops | |---|---|---| | Zapier app | New client details to your other tools. | One trigger; no bookings. | | Timely online booking | Clients book themselves. | Only the client books; no moves or lists for you. | | By hand | Every screen of Timely, one booking at a time. | Your front desk's time. | If you only need new clients copied to your email list, the Zapier app does that. To book, move and bring clients back from ChatGPT or Claude this week, Cotlet works in the Timely account you already have. ## Who runs Cotlet Take Group sp. z o.o. runs Cotlet. It is a software company registered in Poland, EU (VAT PL6342984273), in business since 2019, led by its founders Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Timely tools go to contact@cotlet.dev. ## Timely MCP server: questions ### How do I get access? Sign up free at https://cotlet.dev, open Timely under Integrations in the console and sign in to Timely in its Cloud Browser. The trial starts with your first app and asks for no card. ### How do I connect Timely to ChatGPT or Claude? Sign up at cotlet.dev, log in to Timely once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Timely account through Cotlet, in their phone apps too. ### What can ChatGPT do in Timely? With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Timely: book from DMs; find clients due back; cover a day off. You ask in plain words, and anything that reaches other people waits for your OK first. ### Is there an official ChatGPT or Claude app for Timely? No. Timely has no ChatGPT or Claude connector of its own and Timely has no official MCP server (checked 9 Nov 2026). Cotlet is an independent one that works in ChatGPT, Claude, Cursor and any MCP client, on your signed-in account. ### Can ChatGPT book appointments in Timely? Yes, with Cotlet. ChatGPT finds or adds the client, checks free slots and books the service with the stylist you name, after your OK. ### Can ChatGPT reschedule appointments in Timely? Yes, with Cotlet. ChatGPT moves appointments to another time or stylist, for example on a day off, after your OK. ### Can ChatGPT find clients due back in Timely? Yes, with Cotlet. ChatGPT lists clients not seen in the weeks you name with nothing booked. ### Is this Timely the salon software? Yes. This page is about Timely booking software for hair and beauty businesses (gettimely.com), not the time tracking app with a similar name. ### Is the MCP server different from the REST API? Only in how it is called. Both carry the same 6 tools, inputs, answers, API key and price. Agents use MCP; scripts and HTTP steps use REST. ### Is Cotlet affiliated with Timely? No. Cotlet is independent and not affiliated with Timely or its owner EverCommerce. --- Give your AI agents your signed-in browser. **Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md) **Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet) **Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) **Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md) **Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors) **Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet) 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](https://cotlet.dev/about.md) 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.