Skip to content
MCP server

Faceabot Public holidays

Public holidays for about 200 countries, with next-holiday and date checks

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About Faceabot Public holidays

Faceabot Public holidays is a free MCP server for events and entertainment. It runs as a hosted remote server, so there is nothing to install locally.

Beyond listing a country's holidays for a year, this server answers the two questions agents usually ask: what is the next holiday, and is a specific date a holiday. National and regional holidays are covered for roughly 200 countries.

It is a hosted, keyless endpoint. Faceabot's monitoring page logs 501 checks, all successful, with its test call to is_public_holiday returning a real result each time, most recently in about 1.3 seconds.

The page also points to other holiday servers from different publishers, including one for business days and long weekends, if you need calendar maths on top.

Install

Run in a terminal

claude mcp add --transport http public-holidays https://faceabot.com/tools-mcp/holidays

Add to Settings → Connectors → Add custom connector

https://faceabot.com/tools-mcp/holidays
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "public-holidays": {
      "url": "https://faceabot.com/tools-mcp/holidays"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "public-holidays": {
      "type": "http",
      "url": "https://faceabot.com/tools-mcp/holidays"
    }
  }
}

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

{
  "mcpServers": {
    "public-holidays": {
      "serverUrl": "https://faceabot.com/tools-mcp/holidays"
    }
  }
}

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

{
  "mcpServers": {
    "public-holidays": {
      "type": "http",
      "url": "https://faceabot.com/tools-mcp/holidays"
    }
  }
}

Tools this server provides (1)

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

is_public_holiday
Checks whether a date is a public holiday; used for Faceabot's monitoring check.

What it does

Holiday lists
Returns national and regional holidays for a country and year.
Next holidays
Shows which holidays are coming up.
Date check
Answers whether a given date is a public holiday.
About 200 countries
Broad country coverage with no key.

Good for

  • Avoid scheduling a meeting on a public holiday
  • Plan delivery dates around closures
  • Show upcoming holidays in a team calendar
  • Check a date before sending a time-sensitive email

Pricing

Free

Free, no API key

Prices change. Check faceabot.com before you buy.

Faceabot Public holidays FAQ

Is an API key required?

No, it is free and keyless.

Does it include regional holidays?

Yes, national and regional holidays are listed.

Can I look at other years?

Yes, any year is supported.

Is Faceabot Public holidays free?

Yes. Faceabot Public holidays is free to use.

How do I add Faceabot Public holidays to Claude Code?

Run this command in your terminal: claude mcp add --transport http public-holidays https://faceabot.com/tools-mcp/holidays

What are the best alternatives to Faceabot Public holidays?

The closest alternatives to Faceabot Public holidays are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to Faceabot Public holidays

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

    MCP server

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

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. MaineMCP

    MCP server

    Search public Maine events, communities and startups, with links to the source listings

    • 4 tools
    • Remote
    • Free
    • Events and entertainment