[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.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)

# Book Timetastic time off from your AI agent

> Book Timetastic leave for yourself or your team from chat: check the Wallchart for clashes first, respect staffing limits, cancel if plans change.

Source: https://cotlet.dev/integrations/timetastic-api-mcp-server/book-time-off

Booking leave in Timetastic is one form, but a manager booking for a team first has to read the Wallchart to see who else is off that week.

Cotlet does it in your own Timetastic account with list\_wallchart, book\_time\_off and cancel\_booking, called by your AI agent, an n8n workflow or a script.

[Sign up free](https://cotlet.dev/app/signup?app=timetastic) [All Timetastic tools](https://cotlet.dev/integrations/timetastic-api-mcp-server.md)

Hosted · nothing to install or maintain

## Can Timetastic do this on its own?

Timetastic has no way to book leave outside its own screens and apps except the API, and the API needs an admin user's token (checked 20 Oct 2026). An employee or manager who is not an admin has no API, so leave booked from a chat or a script needs another route.

## How you do it in Timetastic today

1. The person clicks Book time off at the top right of the Wallchart or the Calendar, or clicks and drags across days on the Wallchart to get a pre-populated form.
2. A manager or admin picks the person in the Who for field, and everyone picks the leave type from the Type drop-down.
3. Before submitting, the person reads the Wallchart for the department to see who else is off.
4. The request goes to the approver by email, and the Wallchart and the allowance update once it is approved.
5. Changing plans means opening the booking and clicking the Cancel icon, which only works for tomorrow or later when you are not the approver.

## How to book Timetastic time off from your AI agent

Prompt

```
Book Ana Torres Holiday from Dec 21 to Dec 24 in Timetastic. Check the Wallchart first and stop if two people from her department are already off.
```

1. 01  
### Read the department first  
list\_wallchart for the month of the request and the department of the person shows who is off on the days asked for. If the number of people already off is the limit you named in the prompt, the agent stops and reports the names without booking.
2. 02  
### Pick the leave type  
The agent uses the leave type you named, such as Holiday or Sick leave, exactly as Timetastic lists it. A name your account does not have fails before anything is sent, and the error lists the types you can use.
3. 03  
### Book it and read the answer  
book\_time\_off sends the request and returns the status and the approver who will get it. If Timetastic blocks the booking because of a department limit, the agent reports that message and does not retry.
4. 04  
### Leave overrides to you  
When a manager or admin books for someone and Timetastic shows its staffing warning, the agent stops. It continues only if your prompt allows the override, which sets confirm\_override.
5. 05  
### Undo on request  
If you say the plans changed, cancel\_booking cancels the request with the reason you give. For leave starting today or earlier, only an approver or admin can cancel, and the agent says so.

### What you get back

Example data

```
Wallchart, Support, Dec 21 to 24: nobody else off
Booked Ana Torres, Holiday, Dec 21 to 24 (4 days)
Status: pending, approver Priya Nair
No staffing warning
```

### Other ways to ask

- Book me sick leave for today and tell me who approves it.
- Book Dec 28 to 31 for everyone in Support who has allowance left, one request each.
- Check the Wallchart for the first two weeks of January and tell me the best days for a week off.
- Cancel Ana's Dec 21 booking, her plans changed.

## What Timetastic allows, and what to know first

- Timetastic books sick leave through the same form as other leave: pick Sick leave from the Type drop-down, and the employee, their manager or any admin can record it.
- Timetastic's default leave types are holiday, sick leave, unpaid, maternity/paternity, meeting and compassionate, and an admin can add more under SETTINGS > LEAVE TYPES.
- When a department's Maximum absent limit is exceeded, Timetastic blocks an employee booking for themselves, and shows a manager or admin a warning they can override with Confirm.
- Anyone can cancel their own future leave, but leave for today or earlier must be cancelled by the approver or an admin, and the approver gets an email either way.
- Group bookings skip approval: Timetastic approves them automatically and everyone gets an email.

book\_time\_off and cancel\_booking ask for your OK by default. To run it on a schedule without you, switch confirmation off for those tools in your dashboard.

Sources: [Timetastic Help: Booking time off](https://help.timetastic.co.uk/en/articles/13193354-timetastic-booking-time-off) · [Timetastic Help: Recording and reporting sick leave](https://help.timetastic.co.uk/en/articles/13193340-timetastic-recording-and-reporting-sick-leave) · [Timetastic Help: Maximum absent](https://help.timetastic.co.uk/en/articles/13193336-timetastic-maximum-absent) · [Timetastic Help: Cancelling leave](https://help.timetastic.co.uk/en/articles/13193357-timetastic-cancelling-leave)

## Call book\_time\_off from a script

curl

```
curl -X POST https://cotlet.dev/api/v1/timetastic/time-offs \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"who_for":"Ana Torres","from_date":"2026-12-21","to_date":"2026-12-24","leave_type":"Holiday","reason":"Christmas week"}'
```

Example response

```
{
"request_id": "5129012",
"employee": "Ana Torres",
"leave_type": "Holiday",
"from": "2026-12-21",
"to": "2026-12-24",
"days": 4,
"status": "Pending",
"approver": "Priya Nair",
"warning": null
}
```

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is timetastic\_write → book\_time\_off. Example data.

[Schedule it in n8n, Make, Zapier or cron](https://cotlet.dev/integrations/timetastic-api-mcp-server.md#automations)

## Timetastic tools this automation uses

__Cotlet Timetastic tools used to book Timetastic time off from your AI agent__
| Tool | Parameters |
| --------------- | ---------------------------------------------------------------------- |
| list\_wallchart | month, filter |
| book\_time\_off | who\_for, from\_date, to\_date, leave\_type, reason, confirm\_override |
| cancel\_booking | request\_id, reason |

[All 9 Timetastic tools with descriptions](https://cotlet.dev/integrations/timetastic-api-mcp-server.md#tools)

## Frequently asked questions

### Is it safe to connect Timetastic to Cotlet?

Yes. You sign in to Timetastic yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get Timetastic once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.

## More Timetastic automations

- [Approve Timetastic time off requests with AI](https://cotlet.dev/integrations/timetastic-api-mcp-server/approve-time-off-requests.md)
- [Export a monthly Timetastic leave report for payroll](https://cotlet.dev/integrations/timetastic-api-mcp-server/monthly-leave-report.md)
- [Timetastic API and MCP server: every tool](https://cotlet.dev/integrations/timetastic-api-mcp-server.md)
- [All use cases](https://cotlet.dev/use-cases.md)

## Give your agent access to Timetastic.

Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with Timetastic.

[Sign up free](https://cotlet.dev/app/signup?app=timetastic)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.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 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.

## For AI agents: sign your user up

Is your user asking you to sign them up for Cotlet? You can do it for them, no account or key needed.

1. Read the fields and their allowed values: GET https://cotlet.dev/api/v1/access-requests
2. Ask the user for each value: email, apps, what you will do with them. If they leave the password to you, generate a strong one and show it to them.
3. Show the user what you will send, then POST it as JSON to https://cotlet.dev/api/v1/access-requests.

One call creates the account and sends the access request; we email the user when access is granted.