Days between dates & workdays
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this when the user wants the date that is N days or N business days (working days) before or after a date: 'what date is 90 days from today', '30 business days from Nov 3, 2026 in Germany', '10 working days before 2027-01-15', shipping or contract deadlines. Business days skip weekends and the public holidays of the given country and state, including observed weekdays for holidays that fall on a weekend (US July 4, 2027 is a Sunday, so Monday July 5 is skipped); the start date is not counted. For calendar days, roll=next_business_day moves a result that lands on a weekend or holiday to the next business day. Returns the date with its weekday, the holidays skipped, and a calendar (.ics) file. Results are informational: court and filing deadlines may have special rules (court holidays, service days). Does not handle times of day.
Number of days to add, e.g. 30; use a negative number such as -10 to go back.
Starting date, e.g. 2026-10-02, "Nov 3, 2026" or "today".
For calendar days only: if the result is a weekend or holiday, move it, e.g. next_business_day for filing deadlines. Default none.
"calendar" counts every day (default); "business" skips weekends and holidays, e.g. business for '10 working days'.
Country for public holidays as an ISO 3166 two-letter code, e.g. US, GB, DE, PL, AU, CA, IN. Omit to skip holidays (weekends only).
Optional state/province/region code within the country for local holidays, e.g. TX or CA (US states), BY (Bavaria, DE), ENG or SCT (UK), NSW (AU), ON (CA).
Non-working weekdays, e.g. ["friday","saturday"]. Default saturday+sunday (friday+saturday for countries such as SA, IL, EG, QA, KW).
Extra non-working dates to skip, e.g. company shutdown days ["2026-12-24","2026-12-31"].
Also skip bank-only closing days where the data has them (e.g. Dec 24 and Dec 31 in Germany). Default false.
Use this when the user wants the date that is N days or N business days (working days) before or after a date: 'what date is 90 days from today', '30 business days from Nov 3, 2026 in Germany', '10 working days before 2027-01-15', shipping or contract deadlines. Business days skip weekends and the public holidays of the given country and state, including observed weekdays for holidays that fall on a weekend (US July 4, 2027 is a Sunday, so Monday July 5 is skipped); the start date is not counted. For calendar days, roll=next_business_day moves a result that lands on a weekend or holiday to the next business day. Returns the date with its weekday, the holidays skipped, and a calendar (.ics) file. Results are informational: court and filing deadlines may have special rules (court holidays, service days). Does not handle times of day.
| Argument | Type | Description |
|---|---|---|
| days* | integer | Number of days to add, e.g. 30; use a negative number such as -10 to go back. |
| roll | string | For calendar days only: if the result is a weekend or holiday, move it, e.g. next_business_day for filing deadlines. Default none. |
| unit | string | "calendar" counts every day (default); "business" skips weekends and holidays, e.g. business for '10 working days'. |
| start* | string | Starting date, e.g. 2026-10-02, "Nov 3, 2026" or "today". |
| country | string | Country for public holidays as an ISO 3166 two-letter code, e.g. US, GB, DE, PL, AU, CA, IN. Omit to skip holidays (weekends only). |
| subdivision | string | Optional state/province/region code within the country for local holidays, e.g. TX or CA (US states), BY (Bavaria, DE), ENG or SCT (UK), NSW (AU), ON (CA). |
| weekend_days | array | Non-working weekdays, e.g. ["friday","saturday"]. Default saturday+sunday (friday+saturday for countries such as SA, IL, EG, QA, KW). |
| extra_holidays | array | Extra non-working dates to skip, e.g. company shutdown days ["2026-12-24","2026-12-31"]. |
| include_bank_holidays | boolean | Also skip bank-only closing days where the data has them (e.g. Dec 24 and Dec 31 in Germany). Default false. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"start",
"days"
],
"properties": {
"days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Number of days to add, e.g. 30; use a negative number such as -10 to go back."
},
"roll": {
"enum": [
"none",
"next_business_day",
"previous_business_day"
],
"type": "string",
"description": "For calendar days only: if the result is a weekend or holiday, move it, e.g. next_business_day for filing deadlines. Default none."
},
"unit": {
"enum": [
"calendar",
"business"
],
"type": "string",
"description": "\"calendar\" counts every day (default); \"business\" skips weekends and holidays, e.g. business for '10 working days'."
},
"start": {
"type": "string",
"maxLength": 40,
"description": "Starting date, e.g. 2026-10-02, \"Nov 3, 2026\" or \"today\"."
},
"country": {
"type": "string",
"maxLength": 60,
"description": "Country for public holidays as an ISO 3166 two-letter code, e.g. US, GB, DE, PL, AU, CA, IN. Omit to skip holidays (weekends only)."
},
"subdivision": {
"type": "string",
"maxLength": 60,
"description": "Optional state/province/region code within the country for local holidays, e.g. TX or CA (US states), BY (Bavaria, DE), ENG or SCT (UK), NSW (AU), ON (CA)."
},
"weekend_days": {
"type": "array",
"items": {
"enum": [
"sunday",
"monday",
"tuesday",
"wednesday",
"thursday",
"friday",
"saturday"
],
"type": "string"
},
"maxItems": 6,
"description": "Non-working weekdays, e.g. [\"friday\",\"saturday\"]. Default saturday+sunday (friday+saturday for countries such as SA, IL, EG, QA, KW)."
},
"extra_holidays": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 100,
"description": "Extra non-working dates to skip, e.g. company shutdown days [\"2026-12-24\",\"2026-12-31\"]."
},
"include_bank_holidays": {
"type": "boolean",
"description": "Also skip bank-only closing days where the data has them (e.g. Dec 24 and Dec 31 in Germany). Default false."
}
}
}Use this when the user asks how many days are between two dates (days between dates, count days, date calculator), how many business days or working days are between two dates, or days between dates excluding weekends and public holidays for a country or US state. Returns calendar days, weeks and days, years/months/days, business days, and the holidays skipped by name. The start date is counted; set include_end_date=true to also count the end date (Excel NETWORKDAYS style). Does not handle times of day or time zones. Holidays that fall on a weekend are not double-counted, and their observed weekday off (for example US Independence Day 2026 on Saturday is observed Friday July 3) is skipped as a holiday. Results are informational: legal deadlines may have special rules such as court holidays. Do not use for writing SQL or spreadsheet formulas.
| Argument | Type | Description |
|---|---|---|
| end* | string | Second date, e.g. 2027-01-15. Also accepts "January 15, 2027" or "today". |
| start* | string | First date, preferably YYYY-MM-DD, e.g. 2026-03-03. Also accepts "March 3, 2026", "3 March 2026" or "today". |
| country | string | Country for public holidays as an ISO 3166 two-letter code, e.g. US, GB, DE, PL, AU, CA, IN. Omit to skip holidays (weekends only). |
| subdivision | string | Optional state/province/region code within the country for local holidays, e.g. TX or CA (US states), BY (Bavaria, DE), ENG or SCT (UK), NSW (AU), ON (CA). |
| weekend_days |
Use this when the user asks which public holidays (bank holidays) a country or a state/region has in a year, e.g. 'Poland public holidays 2026' or 'Texas state holidays 2027', usually to plan working days. Returns each holiday with date, weekday, English name and whether it falls on a weekend, including the observed weekday off when a holiday falls on a weekend, plus a CSV file. Does not include school holidays, religious observances that are not days off, or company-specific closures. Do not use to check whether a stock exchange is open.
| Argument | Type | Description |
|---|---|---|
| year | integer | Year, e.g. 2026. Defaults to the current year. |
| country* | string | Country as an ISO two-letter code, e.g. PL, US, GB, DE. |
| subdivision | string | Optional state/region code, e.g. TX (Texas), BY (Bavaria), SCT (Scotland). |
| weekend_days | array | Weekend days used to flag holidays falling on a weekend, e.g. ["friday","saturday"]. Default from the country. |
| include_bank_holidays | boolean | Also list bank-only closing days where available, e.g. Dec 24 in Germany. Default false. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"country"
],
"properties": {
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Year, e.g. 2026. Defaults to the current year."
},
"country": {
"type": "string",
"maxLength": 60,
"description": "Country as an ISO two-letter code, e.g. PL, US, GB, DE."
},
"subdivision": {
"type": "string",
"maxLength": 60,
"description": "Optional state/region code, e.g. TX (Texas), BY (Bavaria), SCT (Scotland)."
},
"weekend_days": {
"type": "array",
"items": {
"enum": [
"sunday",
"monday",
"tuesday",
"wednesday",
"thursday",
"friday",
"saturday"
],
"type": "string"
},
"maxItems": 6,
"description": "Weekend days used to flag holidays falling on a weekend, e.g. [\"friday\",\"saturday\"]. Default from the country."
},
"include_bank_holidays": {
"type": "boolean",
"description": "Also list bank-only closing days where available, e.g. Dec 24 in Germany. Default false."
}
}
}| array |
| Non-working weekdays, e.g. ["friday","saturday"]. Default saturday+sunday (friday+saturday for countries such as SA, IL, EG, QA, KW). |
| extra_holidays | array | Extra non-working dates to skip, e.g. company shutdown days ["2026-12-24","2026-12-31"]. |
| include_end_date | boolean | Count the end date too (adds one day), e.g. true for 'from Monday through Friday'. Default false. |
| include_bank_holidays | boolean | Also skip bank-only closing days where the data has them (e.g. Dec 24 and Dec 31 in Germany). Default false. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"maxLength": 40,
"description": "Second date, e.g. 2027-01-15. Also accepts \"January 15, 2027\" or \"today\"."
},
"start": {
"type": "string",
"maxLength": 40,
"description": "First date, preferably YYYY-MM-DD, e.g. 2026-03-03. Also accepts \"March 3, 2026\", \"3 March 2026\" or \"today\"."
},
"country": {
"type": "string",
"maxLength": 60,
"description": "Country for public holidays as an ISO 3166 two-letter code, e.g. US, GB, DE, PL, AU, CA, IN. Omit to skip holidays (weekends only)."
},
"subdivision": {
"type": "string",
"maxLength": 60,
"description": "Optional state/province/region code within the country for local holidays, e.g. TX or CA (US states), BY (Bavaria, DE), ENG or SCT (UK), NSW (AU), ON (CA)."
},
"weekend_days": {
"type": "array",
"items": {
"enum": [
"sunday",
"monday",
"tuesday",
"wednesday",
"thursday",
"friday",
"saturday"
],
"type": "string"
},
"maxItems": 6,
"description": "Non-working weekdays, e.g. [\"friday\",\"saturday\"]. Default saturday+sunday (friday+saturday for countries such as SA, IL, EG, QA, KW)."
},
"extra_holidays": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 100,
"description": "Extra non-working dates to skip, e.g. company shutdown days [\"2026-12-24\",\"2026-12-31\"]."
},
"include_end_date": {
"type": "boolean",
"description": "Count the end date too (adds one day), e.g. true for 'from Monday through Friday'. Default false."
},
"include_bank_holidays": {
"type": "boolean",
"description": "Also skip bank-only closing days where the data has them (e.g. Dec 24 and Dec 31 in Germany). Default false."
}
}
}