# Timetastic MCP by usefulapi

> Timetastic MCP by usefulapi is a freemium MCP server for hiring and recruiting. Hosted MCP server that lets AI assistants check and manage Timetastic leave for HR teams. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/timetastic/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/timetastic
- **MCP Registry name:** io.usefulapi/timetastic
- **Categories:** [hiring and recruiting](https://ai-powered.com/categories/hiring-and-recruiting)
- **Listing updated:** 2026-11-19

## About

The Timetastic connector is a hosted remote server, so there is nothing to install locally. Once connected, an AI client can look up who is off in a date range, pull leave requests and their status, read a user's allowance and carry-forward, and list leave types and public holidays. The README says the server signs in through OAuth, with the login page asking for a Timetastic API token that an admin creates in the account's integration settings.

Two of its fourteen tools can change data: one submits a leave request and one approves or declines a pending request, with a reason required for declines. Timetastic's own allowance and approval rules still apply, and cancelling or deleting bookings is not offered. The remaining tools are read-only, and a few meta tools report usage and manage the subscription.

The server suits HR staff and team managers who already run leave in Timetastic and want to ask questions about it in natural language. usefulapi describes it as an independent service, not affiliated with Timetastic.

## Features

- **Team absence lookup:** Shows who is off in a chosen date range, including bookings and public holidays.
- **Leave request review:** Lists pending and approved requests and opens individual requests to see dates and duration.
- **Allowance checks:** Reads a user's leave allowance, TOIL and carry-forward for a given year.
- **Approve or decline:** Acts on a pending leave request by id, requiring a reason when declining.
- **Leave requests from chat:** Submits a leave request for a user, department or everyone, subject to Timetastic's rules.
- **Public holiday listing:** Retrieves organisation public holidays filtered by country code or year.

## Good for

- Checking who is off in the team this week before planning a meeting
- Reviewing leave requests waiting for approval
- Confirming a staff member's remaining holiday allowance before they book time off
- Looking up public holidays for a country when planning leave

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http timetastic https://timetastic.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://timetastic.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "timetastic": {
      "url": "https://timetastic.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "timetastic": {
      "type": "http",
      "url": "https://timetastic.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "timetastic": {
      "serverUrl": "https://timetastic.usefulapi.io/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://timetastic.usefulapi.io/mcp
```

Enter a Name (for example "Timetastic MCP by usefulapi"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "timetastic": {
      "type": "http",
      "url": "https://timetastic.usefulapi.io/mcp"
    }
  }
}
```

## Tools

8 of 10 tools say they're read-only. 2 of 10 tools say they can delete or change data. From the server's own tool annotations; not verified by us.

- `timetastic_list_users` (says read-only): List the users (employees) of the Timetastic organisation, optionally by department or including archived users. Timetastic API: GET /api/users.
- `timetastic_get_user` (says read-only): Get one user (employee) by id, with leave and profile details. Timetastic API: GET /api/users/{id}.
- `timetastic_list_leave_types` (says read-only): List the leave types of the organisation (holiday, sickness and other types), with their ids. Timetastic API: GET /api/leavetypes.
- `timetastic_list_leave_requests` (says read-only): List leave requests (holidays and other bookings) in a date range, filtered by user, department or leave type. Pending and approved requests by default. Timetastic API: GET /api/holidays.
- `timetastic_get_leave_request` (says read-only): Get one leave request by id, with its status, dates and duration. Timetastic API: GET /api/holidays/{id}.
- `timetastic_list_absences` (says read-only): List the wallchart entries for a date range: who is off (bookings, public holidays, non-working days). Timetastic API: GET /api/absences.
- `timetastic_list_public_holidays` (says read-only): List the public holidays of the organisation, optionally for one country or year. Timetastic API: GET /api/publicholidays.
- `timetastic_get_user_allowance` (says read-only): Get one user's leave allowance, TOIL and carry-forward for a year. Timetastic API: GET /api/users/{userId}/allowances/{year}.
- `timetastic_request_leave` (says it can change data): WRITE: submit a leave request (booking) in Timetastic for a user, department or everyone. Timetastic applies its own allowance, lock and approval rules, and never overrides them. Refused requests return an error with the reason. Timetastic API: POST /api/holidays.
- `timetastic_approve_or_decline_leave` (says it can change data): WRITE: approve or decline a pending leave request by id. Declining needs a reason. Cancelling and deleting are not offered. Timetastic API: POST /api/holidays/{id}?holidayUpdateAction=Approve|Decline.

## FAQ

### Is this an official Timetastic product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Timetastic.

### How do I connect it?

Add the server URL as a custom connector or remote MCP server in your AI client, then log in with your Timetastic API token. The README says no Authorization header or API key should go in the client config.

### Can the AI change my Timetastic data?

Yes, through two of the fourteen tools: one requests leave and one approves or declines a pending request. The other tools are read-only, and the listing says most MCP clients ask for approval before a tool call runs.

### What does it cost?

The Free plan includes 50 tool calls per month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls. Each paid plan covers this server only.

### Is Timetastic MCP by usefulapi free?

Timetastic MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Timetastic MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http timetastic https://timetastic.usefulapi.io/mcp

### What are the best alternatives to Timetastic MCP by usefulapi?

The closest alternatives to Timetastic MCP by usefulapi are Reactive Resume, Shiftavo MCP by usefulapi, fractio.pl: katalog ekspertów fractional, Klaro – Arztstellen in Deutschland and TianGongShi Bounties.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [Shiftavo MCP by usefulapi](https://ai-powered.com/mcp/shiftavo-mcp-by-usefulapi): Shiftavo MCP by usefulapi is a freemium MCP server for hiring and recruiting.
- [fractio.pl: katalog ekspertów fractional](https://ai-powered.com/mcp/fractio-pl-katalog-ekspertow-fractional): fractio.pl: katalog ekspertów fractional is a free MCP server for hiring and recruiting.
- [Klaro – Arztstellen in Deutschland](https://ai-powered.com/mcp/klaro-arztstellen-in-deutschland): Klaro – Arztstellen in Deutschland is an MCP server for hiring and recruiting.
- [TianGongShi Bounties](https://ai-powered.com/mcp/tiangongshi-bounties): TianGongShi Bounties is a free MCP server for hiring and recruiting.
- [ApplyAll](https://ai-powered.com/mcp/applyall): ApplyAll is a paid MCP server for hiring and recruiting.
- [Farro Jobs](https://ai-powered.com/mcp/farro-jobs): Farro Jobs is a free MCP server for hiring and recruiting.
- [Sales Legends](https://ai-powered.com/mcp/sales-legends): Sales Legends is a free MCP server for sales and crm.

---
Source: https://ai-powered.com/mcp/timetastic-mcp-by-usefulapi
