Documentation

Tools exposed by Business Day Calculator and the limits that apply.

Connect

Server URL: https://workdays.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.

Tools

`business_days_between`

Counts working days between two dates, excluding weekends, public holidays and closure days, and lists what was excluded.

Inputs: start_date, end_date, include_start, include_end, country, region, calendar, weekend, closures
Limits: Counts one calculation. Up to 14 calendar years per call.

How many business days are there between 2026-12-01 and 2027-01-15 in Germany (Bavaria)?

`add_business_days`

Adds or subtracts working days to a date: deadlines, delivery dates, notice periods, SLA due dates.

Inputs: days, start_date, country, region, calendar, weekend, closures
Limits: Counts one calculation. Up to 2,500 days either way. 1 gives the next working day.

What is the date 10 business days after 2026-12-18 in the UK?

`list_holidays`

Lists the public holidays of a country for a year, with the regions each applies to.

Inputs: country, year, region
Limits: Counts one calculation. Holidays of type Public only.

List the 2027 public holidays in Australia for New South Wales.

`common_working_days`

Returns the dates in a range that are working days in every one of up to 5 countries or regions.

Inputs: start_date, end_date, countries, calendar, weekend, closures
Limits: Counts one calculation. Range up to 366 days. One weekend setting applies to all entries.

Which days in December 2026 are working days in the UK, India and California?

`set_calendar`

Saves a calendar with weekend days, closure days or ranges, and an optional country and region.

Inputs: name, weekend, closures, closures_mode, country, region
Limits: No calculation used. 1 saved calendar on Free, 10 on Pro.

Save a calendar called main with Friday and Saturday as the weekend and a closure from 2026-12-24 to 2026-12-31.

`get_calendar`

Returns one saved calendar, or all saved calendars of the account.

Inputs: name
Limits: No calculation used.

Show my saved calendars.

`account_status`

Shows the account email, plan, usage and limits.

Inputs: none
Limits: none

Show my account status.

`activate_license`

Binds a licence key to the account.

Inputs: license_key (string)
Limits: Key must belong to this product.

Activate licence key XXXX-XXXX.

Plan limits

Limit	Free	Pro
calculations	100	10000
saved calendars	1	10

Network behaviour

Outbound requests use the user agent TidyButtonBot/1.0 (+https://workdays.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.