# Holiday Calendar

> Holiday Calendar is an open-source MCP server for productivity. Compute US federal holidays and business-day dates without model guesswork. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, Web
- **Website:** https://starter.modernmustardseed.com/docs/holidays
- **Repository:** https://github.com/modernmustardseed/small-business-mcp-starter
- **MCP Registry name:** com.modernmustardseed/holiday-calendar
- **Categories:** productivity, legal and government
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://starter.modernmustardseed.com/holidays
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "holiday-calendar": {
      "url": "https://starter.modernmustardseed.com/holidays"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/holiday-calendar
