# holidaypaycalculator.co.nz

> holidaypaycalculator.co.nz is an MCP server for legal and government. MCP server for NZ annual holiday pay calculations and enquiries to payroll firms. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** Web, API
- **Website:** https://holidaypaycalculator.co.nz
- **MCP Registry name:** nz.co.holidaypaycalculator/site
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government)
- **Listing updated:** 2026-11-21

## About

The README-style registry entry describes this as the site's own MCP server, offering a calculator and an enquiry function that passes a request to a human. The underlying website is a New Zealand holiday pay calculator that applies the greater-of rule under the Holidays Act 2003, comparing ordinary weekly pay with average weekly earnings and reporting the higher figure for annual leave.

The site's pages show worked examples, explain how ordinary weekly pay and average weekly earnings are derived, and cite Employment New Zealand as the source of the rules. Its embedded tool and guides cover annual holidays only, with public holiday and sick leave treated separately.

The server is aimed at people checking Holidays Act figures in New Zealand, and at developers who want that calculation available to an AI client. The site states it is an information service, not legal or payroll advice.

## Features

- **Annual holiday calculator:** Computes the weekly annual holiday rate using the greater of ordinary weekly pay and average weekly earnings.
- **Human enquiry route:** An enquiry tool hands a request on to a person rather than answering it automatically.
- **Worked NZ examples:** Published cases show how the greater-of rule raises or leaves pay unchanged depending on earnings history.
- **Sourced to Employment NZ:** Rules are attributed to Employment New Zealand and the Holidays Act 2003 as stated on the site.

## Good for

- Checking the weekly rate owed for annual leave under NZ law
- Estimating the uplift over ordinary weekly pay for an employee with overtime or commission
- Giving an AI assistant access to NZ holiday pay calculations
- Sending a holiday pay query to a human payroll adviser

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http site https://holidaypaycalculator.co.nz/mcp
```

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

```sh
https://holidaypaycalculator.co.nz/mcp
```

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

```json
{
  "mcpServers": {
    "site": {
      "url": "https://holidaypaycalculator.co.nz/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "site": {
      "type": "http",
      "url": "https://holidaypaycalculator.co.nz/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "site": {
      "serverUrl": "https://holidaypaycalculator.co.nz/mcp"
    }
  }
}
```

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

```sh
https://holidaypaycalculator.co.nz/mcp
```

Enter a Name (for example "holidaypaycalculator.co.nz"), 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": {
    "site": {
      "type": "http",
      "url": "https://holidaypaycalculator.co.nz/mcp"
    }
  }
}
```

## FAQ

### How is annual holiday pay calculated in New Zealand?

At least the greater of ordinary weekly pay at the start of the holiday or average weekly earnings, where average weekly earnings are gross earnings for the previous 12 months divided by 52.

### How much annual leave am I entitled to in New Zealand?

Four weeks of paid annual holidays after 12 months of continuous employment, according to the site.

### Does this calculator cover public holidays?

No. Public holidays, alternative holidays and sick or bereavement leave use daily calculations and are not covered.

### How do I add holidaypaycalculator.co.nz to Claude Code?

Run this command in your terminal: claude mcp add --transport http site https://holidaypaycalculator.co.nz/mcp

### What are the best alternatives to holidaypaycalculator.co.nz?

The closest alternatives to holidaypaycalculator.co.nz are finalpaycalculator.co.nz, noticeperiodcalculator.co.nz, leavetracker.uk, employeecostcalculator.co.nz and rechnerhq.com.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [finalpaycalculator.co.nz](https://ai-powered.com/mcp/finalpaycalculator-co-nz): finalpaycalculator.co.nz is a free MCP server.
- [noticeperiodcalculator.co.nz](https://ai-powered.com/mcp/noticeperiodcalculator-co-nz): noticeperiodcalculator.co.nz is an MCP server for hiring and recruiting.
- [leavetracker.uk](https://ai-powered.com/mcp/leavetracker-uk): leavetracker.uk is a free MCP server for legal and government.
- [employeecostcalculator.co.nz](https://ai-powered.com/mcp/employeecostcalculator-co-nz): employeecostcalculator.co.nz is an MCP server for hr and payroll.
- [rechnerhq.com](https://ai-powered.com/mcp/rechnerhq-com): rechnerhq.com is an MCP server for legal and government.
- [noticeperiodcalculator.co.uk](https://ai-powered.com/mcp/noticeperiodcalculator-co-uk): noticeperiodcalculator.co.uk is a free MCP server for legal and government.
- [employmentrightschecker.co.uk](https://ai-powered.com/mcp/employmentrightschecker-co-uk): employmentrightschecker.co.uk is an MCP server for legal and government.
- [SA Payroll & Labour Rules](https://ai-powered.com/mcp/sa-payroll-and-labour-rules): SA Payroll & Labour Rules is a freemium MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/holidaypaycalculator-co-nz
