Skip to content
MCP server

Holiday Calendar

Compute US federal holidays and business-day dates without model guesswork

Install
Pricing
Open source
Platforms
API, Web
Runs
Remotely
Version
1.0.1
Listing updated
1 day ago

About Holiday Calendar

Holiday Calendar is an open-source MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

This connector answers date questions that small businesses ask constantly: when is the next federal holiday, is a date a business day, what is ten business days after an invoice date. It computes the eleven holidays set out in 5 U.S.C. 6103 for years 2021 through 2100, moving Saturday holidays to the Friday before and Sunday ones to the Monday after.

All five tools are read-only and make no network calls, so nothing leaves the server and no sign-in is needed. The start date is never counted when adding business days, while counting between two dates includes both ends.

It is a worked example from Modern Mustard Seed's open-source starter kit for building remote Claude connectors. The docs warn that states, banks and private employers may observe other days.

Install

Run in a terminal

claude mcp add --transport http holiday-calendar https://starter.modernmustardseed.com/holidays

Add to Settings → Connectors → Add custom connector

https://starter.modernmustardseed.com/holidays
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "holiday-calendar": {
      "url": "https://starter.modernmustardseed.com/holidays"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "holiday-calendar": {
      "type": "http",
      "url": "https://starter.modernmustardseed.com/holidays"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "holiday-calendar": {
      "serverUrl": "https://starter.modernmustardseed.com/holidays"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "holiday-calendar": {
      "type": "http",
      "url": "https://starter.modernmustardseed.com/holidays"
    }
  }
}

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

list_federal_holidays
Lists the eleven federal holidays for a year with observed dates.
next_federal_holidays
Finds the next observed federal holidays from a date.
check_business_day
Checks whether a date is a US business day.
add_business_days
Adds or subtracts business days from a date.
count_business_days
Counts business days between two dates.

What it does

Holiday listing
Lists a year's federal holidays with observed dates and weekdays.
Next holidays
Finds upcoming holidays and days remaining.
Business-day check
Says if a date is a working day and why not.
Add business days
Moves forward or backward, listing skipped holidays.
Count business days
Counts working days between two dates inclusive.

Good for

  • Compute an invoice due date in business days
  • See which holidays fall on weekends in a year
  • Count working days left in a quarter
  • Set delivery or notice periods
  • Check if a date is a federal workday

Pricing

Open source

Free; example from an MIT-licensed starter kit

Prices change. Check starter.modernmustardseed.com before you buy.

Holiday Calendar FAQ

Which holidays does it use?

The eleven in 5 U.S.C. 6103(a).

Does it need an account?

No sign-in or key, and tools make no network calls.

What range of years?

2021 through 2100 for holiday listing.

Does it cover state holidays?

No; states, banks and private employers can observe other days.

Is Holiday Calendar free?

Yes. Holiday Calendar is open source, so you can use and self-host it for free.

How do I add Holiday Calendar to Claude Code?

Run this command in your terminal: claude mcp add --transport http holiday-calendar https://starter.modernmustardseed.com/holidays

What are the best alternatives to Holiday Calendar?

The closest alternatives to Holiday Calendar are Ha MCP, Concord MCP, note1, NY LLC Publication (FileMyPublication) and CalderFlow.

Alternatives to Holiday Calendar

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government