• LOCAL
  • SCHEDULE
  • CALENDAR
  • HUMAN

How to identify regional observances with your AI

Connect Calendarific to your AI client to pull local holiday data. Once connected, your agent handles the lookup for specific states or regions.

Ask AI about this page

Short answer

How can I find local or state holidays using my AI?

Your AI uses the list_holidays_by_location tool to fetch specific observances for a given state, province, or country. This helps you spot local scheduling conflicts that general holiday lists miss. You'll see the specific dates and names for those regions below.

The outcomes.

Where your holiday data lands.

The AI processes your location request and organizes the results into these categories.

LOCAL

Regional holiday lists

The AI pulls specific state or provincial observances. You get a clean list of dates that only affect certain areas.

SCHEDULE

Conflict detection

The AI identifies which dates will impact your specific regional operations. This helps you avoid scheduling meetings on local holidays.

CALENDAR

Date verification

The AI confirms the exact day of the week and date for any regional observance. This ensures your planning stays accurate.

HUMAN

Manual review

You decide which regional holidays actually matter for your specific project or client. The AI provides the data, but you make the call.

The workflow

What your AI does when the request arrives.

The AI acts as a bridge between your chat interface and the Calendarific database.

  1. Identify location

    Your agent parses your request to find the specific state, region, or country you are asking about.

    list_holidays_by_location

  2. Fetch regional data

    The AI calls the tool to pull all observances tied to that specific geographic area.

    list_holidays_by_location

  3. Filter results

    The AI narrows down the list to show only the relevant holidays for the timeframe you requested.

    list_holidays_by_location

  4. Present findings

    The AI presents the dates and names of the observances in your chat window.

    list_holidays_by_location

Try it

Copy these to start.

Use these prompts to trigger the holiday lookup.

Starting points

Swap out the bracketed locations for the specific state or region you need to check.

Calendarific Connector

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

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

  • What are the state holidays in [California] for this year?

  • Find all regional observances in [Ontario] for next month.

  • Check if there are any local holidays in [Texas] during the second week of July.

  • List the upcoming holidays for [New York] so I can update my project sheet.

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

Start here

Connect Calendarific once, then ask.

Click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start asking questions immediately.

Connect Calendarific to your AI

FAQ

How this task behaves.

  • 01

    Can the AI add these holidays to my Google Calendar?

    No. This MCP only reads holiday data from Calendarific. You must manually add the dates to your calendar yourself.

  • 02

    Does the AI know about holidays in every country?

    The AI can only find holidays for locations supported by the list_holidays_by_location tool.

  • 03

    Can the AI change the names of the holidays?

    No. The AI reports the official names of the observances as they exist in the database.

  • 04

    Will the AI notify me when a holiday is approaching?

    No. The AI is reactive. It only provides information when you specifically ask it to look up a date or location.

  • 05

    Can I ask for holidays for a specific city?

    The tool works by location, so you can specify states, provinces, or countries to get the relevant regional data.

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

Connect Calendarific to Claude, Cursor, ChatGPT & more