• COUNT
  • TARGET
  • REGIONAL
  • HUMAN

How to calculate workdays with your AI agent

Connect the Holiday API to your agent to handle complex scheduling and deadline math. It handles the regional holiday logic so you don't have to.

Ask AI about this page

Short answer

How can I calculate workdays with my AI?

Your agent uses the Holiday API to count business days between two dates or find a specific date in the future based on a workday count. It accounts for regional holidays to ensure your math is accurate. You'll see how the agent handles these calculations below.

The results

Where your scheduling tasks land.

The agent processes your date requests and delivers these specific outcomes.

COUNT

Business day totals

The agent calculates the exact number of working days between two specific dates. You get a clean number that ignores weekends and holidays.

TARGET

Future deadline dates

Tell your agent to find a date that is X workdays away. It skips holidays and weekends to give you the correct calendar date.

REGIONAL

Global holiday logic

The agent applies holiday rules for different countries. This ensures your project timelines stay realistic across different regions.

HUMAN

Manual calendar review

You decide if the calculated dates fit your specific company policy or custom non-working days. The agent handles the standard holidays, but you manage the internal exceptions.

The workflow

What your AI does when a date request arrives.

The agent moves from raw dates to actionable business schedules using specific holiday data.

  1. Identify the date range

    The agent looks at your start and end dates to prepare for the calculation.

    get_workdays_count

  2. Calculate the gap

    The agent determines the number of business days by subtracting weekends and regional holidays from the total span.

    get_workdays_count

  3. Project future dates

    If you need to find a deadline, the agent counts forward from a start date until it hits the required number of workdays.

    get_next_workday

  4. Verify regional rules

    The agent checks the specific holiday calendar for the country you mentioned to ensure accuracy.

    get_next_workdayget_workdays_count

Try it

Copy these to start.

Use these prompts to trigger the Holiday API tools.

Starting points

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

Holiday API Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/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 — Holiday API capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "holiday-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_SMxFPybnCSX99kH0d7ecnowVLqRi196StERNKHpz/mcp"
    }
  }
}
Copy into chat04

  • How many workdays are there between March 1st and April 15th in France?

  • What is the date 10 workdays from today in the United Kingdom?

  • Calculate the business days between October 1st and December 25th in the United States.

  • Find the next workday after July 4th in the US.

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

Start here

Connect Holiday API once, then ask.

One click connects this MCP to your client. Your credentials stay encrypted and secure.

Connect Holiday API to your AI

FAQ

How this task behaves.

  • 01

    Can the AI add my company's custom holidays?

    No. The agent only uses the standard holiday calendars provided by the API.

  • 02

    Does the AI change my calendar events?

    No. The agent only performs calculations and provides dates. It cannot write to or modify your calendar.

  • 03

    Can it calculate workdays for any country?

    Yes, as long as the country is supported by the Holiday API's data.

  • 04

    Will it include weekends in the count?

    No. The tools are specifically designed to exclude weekends and holidays from the workday count.

  • 05

    Can I ask for the number of workdays in a specific time zone?

    No. The tools calculate based on calendar dates and country-specific holidays, not time zone offsets.

  • More questions about Holiday API? The Connector page answers them. See everything the Holiday API Connector can do

Connect Holiday API to Claude, Cursor, ChatGPT & more