This server provides an MCP interface for the Timetastic API, enabling agentic clients to query and manage absence, leave, and related workforce data.

Absences

• List who is off between specified dates (up to 31 days), merging bookings, public holidays, non-working days, and other events.

Leave Bookings (Holidays)

• List holidays with rich filtering (date, status, user, department, leave type, approver, etc.) with pagination

• Get a single holiday by ID

• Book leave (including half-days, hourly bookings, admin overrides) for yourself, a department, or everyone

• Approve, decline, or cancel individual or group bookings

Users

• List, get, add, edit, archive, and restore users

• Get user contact details (Pro accounts only)

• Assign public holidays to a user by country/region

Departments

• List, get, create, edit, and delete departments

Leave Types

• List, get, create, update, and delete leave types

• List valid colors and icons for leave types

Allowances

• List allowances, carry-forward, and TOIL for all users or a specific user

• Update annual allowances and carry-forward amounts

• Add, update, and delete TOIL (Time Off In Lieu) entries

Locked Dates

• List, add, and delete locked date periods (scoped to organisation, department, or user)

Public Holidays

• List public holidays (filterable by country, year, or user), get a specific holiday, and list available countries

Webhooks

• List recent webhook events (up to 30 days of history)

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@timetastic-mcp list upcoming holidays for Jane Doe"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.