Timely MCP Server

Appointments, clients and services in Timely salon and spa booking software.

Máy chủ MCP được lưu trữ

npx add-mcp 'https://cotlet.dev/mcp/v1/timely'

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

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.

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Timely. Timely is a trademark of its owner. If Timely's own integrations cover what you need, use them first.

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 needTimely APIZapier appCotlet
New clientsNo docsTriggerYes
Book or moveNo docsNoYes, after your OK
Clients due backNo docsNoYes
Ask in ChatGPT or ClaudeNoNoYes
SetupNone possibleZaps to buildSign in once

Checked 8 Nov 2026. Sources: Timely app integrations, Timely on Zapier, Timely 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, <your key>
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: <your key>
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).

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.
ActionUndo
Book an appointmentYes, cancel it
Move an appointmentMove it back; a reminder already sent stays sent
Add a clientYes, 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.

JobCallsCredits
Booking from a message3 × 1203,600
Clients due back, weekly2 × 480
Appointment moved3 × 25750
Gaps checked, daily1 × 26260
Cloud Browser, 30 days1,500
Total6,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

OptionWhat it doesWhere it stops
Zapier appNew client details to your other tools.One trigger; no bookings.
Timely online bookingClients book themselves.Only the client books; no moves or lists for you.
By handEvery 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.

Also listed on: Odel, mcpbeat

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 when you sign up 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 · 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.