Calendarific MCP. Know if a country is open for business, anywhere in the world.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Calendarific. This server connects global holiday data directly to your AI client. It lets you check public, religious, and local holidays across 230+ countries and regions.
You can list holidays for a specific country and year, or filter results by state or holiday type. It's essential for any project managing international schedules or global operations.
What your AI agents can do
Get account info
Checks the current status of the Calendarific integration.
List holidays
Retrieves a list of holidays for a specific country and year.
List holidays by location
Lists holidays specific to a state or region within a country.
Find all public, religious, and local holidays for any country within a specified year.
Filter holiday results to match a specific state or local region code.
Limit holiday checks to a specific type, such as National or Religious observances.
Retrieve the full directory of supported countries and languages for accurate queries.
Check the health and status of the Calendarific API key integration.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Calendarific MCP Server: 6 Tools for Global Date Management
Use these tools to retrieve, filter, and validate public, religious, and regional holiday schedules across any supported country.
019d7567get account info
Checks the current status of the Calendarific integration.
019d7567list holidays
Retrieves a list of holidays for a specific country and year.
019d7567list holidays by location
Lists holidays specific to a state or region within a country.
019d7567list holidays by type
Lists holidays filtered by category, such as National or Religious observances.
019d7567list supported countries
Provides a list of all 230+ supported countries and their ISO codes.
019d7567list supported languages
Lists all supported languages for the API.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Calendarific, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Calendarific - Global Holiday Data for Scheduling
This server hooks up global holiday data right into your AI client. You can check public, religious, and local holidays across over 230 countries and regions. It's what you need if your project deals with international schedules or global operations.
When you use the list_holidays tool, you get a full rundown of holidays for a specific country and year. You can use list_holidays_by_location to narrow those results down to a particular state or region within a country. If you only care about certain types of days, list_holidays_by_type lets you filter by category, like National or Religious observances.
You'll find the list_supported_countries tool gives you a complete directory of all 230+ supported countries and their ISO codes, and the list_supported_languages tool lists every language the API supports. Before you start, running get_account_info lets you check the current status of the Calendarific integration and make sure your API key's working right.
How Calendarific MCP Works
- 1 Subscribe to the Calendarific server and provide your API key.
- 2 Ask your AI client to check a specific date range or location (e.g., 'Show me holidays in New York for 2025').
- 3 The server calls the appropriate tool, and your AI client presents the list of relevant holidays.
The bottom line is that your AI client handles the complexity of querying the API using simple conversation.
Who Is Calendarific MCP For?
Anyone whose job involves coordinating global schedules. This includes Operations Managers who need to know if an international office is closed, Travel Planners who schedule trips across borders, and Developers building applications that must respect local market holidays.
Checks if an international branch location is observing a holiday before scheduling a meeting or launching a campaign.
Retrieves holiday calendars for multiple destinations to build accurate travel timelines and book flights.
Integrates holiday checking into application logic to prevent feature deployment on a recognized national holiday.
What Changes When You Connect
- Check global dates instantly. Instead of manually searching multiple country-specific calendar websites, you ask your AI client to run
list_holidaysfor any country and year. It gives you a consolidated view of public, religious, and local observances. - Pinpoint regional closures. Need to know if a holiday only affects New York and not the whole state? Use
list_holidays_by_locationto check for state-specific closures, avoiding planning errors. - Target specific observance types. Don't care about public holidays, just need to know when religious services are observed?
list_holidays_by_typelets you filter for National, Observance, or Religious dates. - Build reliable country checks. Before writing code, use
list_supported_countriesto get the definitive ISO codes and validate the country code for your query. This prevents vague input errors. - Confirm language support. Use
list_supported_languagesto make sure your AI client can correctly process the required language for the country you're targeting.
Real-World Use Cases
Scheduling a global product launch.
The marketing team needs to launch a campaign across Brazil and Germany. Instead of checking two different national holiday sites, they ask their agent to run list_holidays for both countries and the current year. The agent returns a combined list, showing them the specific dates they must avoid for a smooth global rollout.
Planning international employee travel.
An HR manager is organizing a trip for staff visiting France and Quebec. They use the agent to run list_holidays_by_location for both locations. The agent flags that while France has a general holiday, Quebec has a specific, local observance, ensuring the trip schedule works for everyone.
Validating application deployment windows.
A developer needs to ensure a new feature deploys only when a target market is fully operational. They use list_holidays_by_type to check for 'National' holidays in the target country, cross-referencing it with list_supported_countries to ensure the correct ISO code is used.
Supporting localized content rollouts.
A localization team is preparing content for Japan. They ask the agent to run list_supported_countries and list_supported_languages first. This confirms the country and language are supported, then they use list_holidays to confirm the holiday schedule for the upcoming quarter.
The Tradeoffs
Assuming the country code.
Manually searching for 'Mexico' holidays and assuming the code is 'MX'. This often fails because the user might confuse the country name with the required ISO code, leading to a blank result or an error.
→
Always run list_supported_countries first. This confirms the correct ISO code for Mexico, ensuring list_holidays uses the right identifier from the start.
Ignoring regional variations.
Checking for 'Christmas' holidays for the US using only a general search. This might miss that the holiday is a federal observance but the local state might have a different closure date.
→
Use list_holidays_by_location to narrow the search down to the specific state or region (e.g., US-NY) to catch local exceptions.
Mixing up holiday types.
Thinking all 'National' holidays are the same. A developer might check for a general national holiday and miss that a specific, smaller religious observance is also happening that day.
→
If you need to check more than just the biggest holidays, use list_holidays_by_type to isolate and check for specific types, like 'Religious' or 'Observance'.
When It Fits, When It Doesn't
Use this if your project depends on knowing the operational status of a location at a specific time. You need to check for any date restriction, whether it's a public holiday, a religious observance, or a local regional closure.
Don't use this if you just need to know the general operating hours of a store. For that, you need a direct business hours API. If you need a full list of countries, run list_supported_countries first; don't rely on memory.
The core workflow is: Use list_supported_countries to get the code -> Use list_holidays or list_holidays_by_location to check the date -> Use list_holidays_by_type if you only care about one category. If you're building an application, you should use this server to validate all date parameters.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Calendarific. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 6 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Coordinating global schedules is a nightmare of tabs and conflicting dates.
Right now, if your team needs to plan an event across multiple countries, you're stuck. You have to open Google for Country A's holidays, then open a local site for Country B's observances. You cross-reference spreadsheets, manually checking if the dates match up. It’s slow, it’s error-prone, and you always feel like you missed something.
With the Calendarific MCP Server, you just ask your agent. You say, 'What are the holidays in Germany and Brazil for Q3?' The agent handles the API calls, checks the data, and hands you one single, definitive list of dates to avoid. It's done in a conversation.
List holidays by type: Check specific observance schedules.
Manually, you might check the main national holiday calendar, but that list usually only covers the biggest events. If you need to know when the local community observes a religious holiday, you have to find a separate, niche calendar, which is a pain to manage.
Now, using the `list_holidays_by_type` tool, you can specifically query for just 'Religious' dates, or just 'Observance' days. You isolate the exact data you need, without wading through national public holidays. It gives you surgical precision.
Common Questions About Calendarific MCP
How do I use the `list_holidays` tool for a specific date? +
The list_holidays tool checks a country and year. While you can't specify a single day, you can run it for a narrow date range to verify if a specific date is a holiday. Always confirm the country code using list_supported_countries first.
Is the `list_holidays_by_location` tool better than `list_holidays`? +
Yes, if your target area is a state or region within a country. list_holidays_by_location provides granular data that list_holidays might miss, especially for localized holidays like state-specific observances.
What is the difference between `list_holidays_by_type` and `list_holidays`? +
list_holidays gives you everything for a country/year. list_holidays_by_type lets you filter that massive list down to only one category, such as 'National' or 'Religious' holidays, making the output much cleaner.
How do I find all supported country codes before I start querying? +
You must run list_supported_countries. This tool gives you the full directory of 230+ supported countries and their official ISO codes, preventing any input errors.
What should I use for the `list_supported_countries` tool to ensure I get the correct ISO codes? +
The list_supported_countries tool provides the definitive list of 230+ countries and their associated ISO codes. This ensures you use the exact code required by the list_holidays tool, preventing query failures.
If I want to check a holiday for a specific month, should I use `list_holidays` or `list_holidays_by_location`? +
Use list_holidays for date-specific queries. While list_holidays_by_location filters by region, list_holidays handles targeted date lookups across a given country and year.
How do I handle rate limits or quota issues when using the `list_holidays` tool? +
Rate limit handling is managed by the underlying Calendarific API. If you encounter quota errors, implement exponential backoff in your agent's logic and check the API documentation for specific limits.
Can I combine filtering using `list_holidays_by_type` and `list_holidays_by_location` to narrow down results? +
You can combine these filters in a single natural language prompt to your agent. The system handles the sequencing, allowing you to ask for, for example, 'National holidays in California'.
How do I list all the holidays for a specific country in 2024? +
Simply ask the agent to list_holidays and provide the Country code (e.g., 'US' or 'BR') and the year '2024'. It will retrieve the full list from Calendarific.
Can I filter holidays by type, like only religious holidays? +
Yes! Use the list_holidays_by_type tool and provide the country, year, and type (e.g., 'religious'). Your agent will return only the matching observances.
How do I see which countries are supported by Calendarific? +
Use the list_supported_countries tool. It will retrieve the complete directory of over 230 countries currently available in the Calendarific API.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
String Metrics Analyzer
Bypass LLM tokenization blindness. Get exact character counts, word counts, and specific string occurrences deterministically.
Browser Bookmarks Parser
Turn messy Chrome, Safari, and Firefox bookmark HTML exports into clean, structured JSON data. Instantly allow your AI to organize your digital life and remove duplicate links.
Bounsel
Manage your contract lifecycle via Bounsel — list documents, automate templates, and request signatures directly from any AI agent.
You might also like
Restful Booker
Manage hotel bookings via the Restful Booker API—create, retrieve, update, and delete reservations directly from your AI agent.
Airbnb
Search and manage Airbnb listings, experiences, reservations, and pricing directly from any AI agent.
Runn
Connect your AI to Runn for complete visibility into project pipelines, capacity planning, resource allocations, and timesheet actuals directly via chat.