Holiday Calendar
Compute US federal holidays and business-day dates without model guesswork
- 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/holidaysAdd to Settings → Connectors → Add custom connector
https://starter.modernmustardseed.com/holidaysAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"holiday-calendar": {
"url": "https://starter.modernmustardseed.com/holidays"
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

NY LLC Publication (FileMyPublication)
MCP serverNew York LLC publication rules, deadline, county prices, clerks and notice text
- 8 tools
- Remote
- Free
- Legal and government

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government