• ACCURATE
  • LOCALIZED
  • AUTOMATED
  • HUMAN

How to calculate business day deadlines with your AI

Connect this MCP once. After that, your agent handles all the calendar math for you.

Ask AI about this page

Short answer

How can I find a deadline that skips weekends and holidays?

Tell your AI how many business days a task takes and which country's holidays to respect. It uses the add_business_days tool to jump over non-working days and give you a specific date. You'll get an exact calendar date instead of a rough estimate.

The results

What you get from your AI

The AI handles the logic, leaving you with clear dates.

ACCURATE

Exact end dates

The AI uses the add_business_days tool to skip weekends and holidays. You get a specific calendar date for your deadline.

LOCALIZED

Holiday awareness

The agent accounts for specific national holidays. This prevents you from scheduling work on days when offices are closed.

AUTOMATED

No manual counting

The AI does the heavy lifting of counting days. You don't have to manually check a calendar to see if a date falls on a Sunday.

HUMAN

Final review

You decide if the calculated date works for your specific project needs. The AI provides the math, but you keep the control.

The workflow

What your AI does when a deadline request arrives.

The AI moves from your request to a calculated date through a few logical steps.

  1. Parse the request

    Your agent identifies the start date, the number of days to add, and the target country from your prompt.

    add_business_days

  2. Calculate the date

    The AI runs the math to skip over weekends and the specific holidays you mentioned.

    add_business_days

  3. Verify the result

    The agent checks the final date against the holiday rules to ensure it lands on a valid business day.

    add_business_days

  4. Present the date

    The AI gives you the final date in a clear format so you can add it to your schedule.

    add_business_days

Try it

Copy these to start.

Use these prompts to trigger the calculation immediately.

Starting points

Swap out the bracketed info with your actual dates and countries.

Nager.Date API Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_ez6FW8I6M2Qqs1ETKpnpE6wJ2qKA9lNwhiYc7Ghw/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Nager.Date API capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "business-timezone-holiday-scheduler-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_ez6FW8I6M2Qqs1ETKpnpE6wJ2qKA9lNwhiYc7Ghw/mcp"
    }
  }
}
Copy into chat04

  • Add 10 business days to October 1st, 2024, accounting for US holidays.

  • If a contract starts on Monday, May 6th, when is the 15th business day in the UK?

  • Calculate the deadline for a 5-day task starting today in Germany.

  • What is the date 20 business days from now if we skip all weekends and Canadian holidays?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Business Timezone & Holiday Scheduler once, then ask.

Click the link to connect. Your credentials stay encrypted, and you can start using the tools in your preferred AI client right away.

Connect Business Timezone & Holiday Scheduler to your AI

FAQ

How this task behaves

  • 01

    Can the AI change my actual Google Calendar?

    No. The AI only calculates the dates. You have to manually update your calendar or move the dates yourself.

  • 02

    Does it know about holidays in every country?

    It uses the holiday data provided by the tool to identify specific national holidays for the country you name.

  • 03

    Can the AI create new holiday rules?

    No. The AI can only use the existing holiday schedules available through the tool.

  • 04

    What happens if I don't specify a country?

    The AI will ask you to specify a country so it knows which holiday schedule to apply.

  • 05

    Can the AI calculate timezones too?

    This specific task focuses on business day math and holiday skipping.

  • More questions about Business Timezone & Holiday Scheduler? The Connector page answers them. See everything the Business Timezone & Holiday Scheduler Connector can do

Connect Nager.Date API to Claude, Cursor, ChatGPT & more