Calendarific MCP. Schedule global events by checking local holidays instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
The Calendarific MCP gives your agent global holiday intelligence. It provides real-time access to public, bank, and religious holidays for over 200 countries worldwide.
Need to schedule an international meeting or plan a product launch across borders? This tool lets you check local non-working days automatically, eliminating calendar guesswork.
What your AI agents can do
Get holidays
Gets all public and bank holidays for a specified country and year.
List supported countries
Returns a list of every country and region the system can check for holidays.
Lists all regions the system recognizes, ensuring you don't waste time querying an unsupported country.
Retrieves a full list of public and bank holidays for any specified country and year.
Filters the holiday data to check only for specific months or days, ideal for precise scheduling checks.
Compares holiday calendars between multiple countries to find workable overlap periods.
Validates your operational regions against the global database of supported locations.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Calendarific Alternative: 2 Tools Available
These two tools allow you to validate regional support and pull comprehensive lists of public, bank, and religious holidays for any country.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Calendarific on Vinkius019d8422get holidays
Gets all public and bank holidays for a specified country and year.
019d8422list supported countries
Returns a list of every country and region the system can check for holidays.
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,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ 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
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 2 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Manually tracking global holidays shouldn't take up your afternoon.
Today, setting a meeting across three continents means opening three different Google Calendar apps. You cross-reference national holiday pages for each region, then you manually check if the date is marked as 'bank holiday' or if it's tied to a specific religious observance. It’s tedious copy-pasting and endless tabs.
With this MCP, your agent handles all that complexity in seconds. You ask for dates, and it gives you back clean results that account for every type of local non-working day. The whole process is immediate.
Getting full holiday intelligence with the `get_holidays` tool.
You no longer have to rely on outdated or incomplete internal data sheets. The agent uses `get_holidays` to pull real-time information, allowing you to compare calendars between countries side-by-side and immediately spot potential conflicts.
What's different now is that the schedule isn't just theoretical; it's globally verified against a comprehensive database of current public and religious observances.
What you can do with this MCP connector
When coordinating events internationally, knowing when people actually work is half the battle. This MCP equips your agent with a global database of public, bank, and religious holidays covering over 200 countries. You can ask it to fetch all holiday dates for any given country and year, or narrow results down by specific months.
It’s designed to handle complex scheduling problems—you just tell the agent the goal, and it finds the date constraints.
The process is secure: when you connect your API key, credentials pass through a zero-trust proxy on Vinkius. This means your keys are used only for transit; they never sit on disk. Your agent acts like a dedicated global coordinator, making sure every deadline or launch date accounts for local laws and festivals.
You can list all supported countries first to validate your scope before checking dates, building truly comprehensive automation chains with other MCPs.
019d8422-76a2-7211-8c86-ff6bedce8638 
How Calendarific MCP Works
- 1 Subscribe to this MCP and enter your API key.
- 2 Your agent uses that connection to first check if a country is supported by calling
list_supported_countries. - 3 Then, it executes the query using
get_holidays, passing in the validated country code and target year.
The bottom line is you get accurate, verifiable dates for any global operation without manually checking local government websites.
Who Is Calendarific MCP For?
Project Managers who struggle to coordinate deadlines across time zones. Operations engineers who need automated availability checks. Travel Planners needing instant regional festival data.
Needs to ensure a global project launch date doesn't fall on a local bank holiday in any of the target countries.
Automates calendar updates and regional availability checks for multi-market product rollouts.
Researches destination country calendars to recommend optimal travel dates, avoiding festivals or holidays.
What Changes When You Connect
- Never risk a missed deadline again. The
get_holidaystool checks for public, bank, and religious holidays in any country you name. - Stop wasting time researching unsupported locations. Use
list_supported_countriesto validate your market scope against 200+ regions instantly. - Plan marketing campaigns with precision. Knowing when a major regional festival or national holiday occurs helps you schedule launches right before the rush.
- Automate coordination. You can use the agent to compare calendars across multiple countries, finding true working overlaps for international teams.
- Handle complexity easily. The MCP automatically filters out non-working days, letting your agent focus only on actionable dates.
Real-World Use Cases
Scheduling a Global Meeting
A Project Manager needs to book a kickoff call involving teams in Germany and Australia. Instead of manually cross-referencing calendars, the agent uses get_holidays for both countries and suggests three working time slots that fall outside all local holidays.
New Market Entry Validation
An Ops Engineer is expanding services to a new territory. They first call list_supported_countries to ensure the location is recognized, then use get_holidays to validate if any regional holidays could impact initial launch dates.
Event Planning Around Festivals
An E-commerce Manager wants to run a sale in Mexico. They ask the agent, and it uses its knowledge of religious and national holidays to suggest the best two weeks that avoid major local celebrations, maximizing visibility.
Comparing Operational Regions
A global team needs to set up compliance reporting across three different continents. The agent calls get_holidays for all three and summarizes any potential holiday overlaps or conflicts in the coming quarter.
The Tradeoffs
Hardcoding Holiday Lists
Creating a spreadsheet with fixed dates for holidays, which immediately becomes obsolete when local governments change rules or introduce new bank days.
→
Use the get_holidays tool. It pulls current, verifiable data from over 200 countries and handles regional changes automatically.
Checking Only National Holidays
Assuming that a 'national' holiday is always a day off, when in fact many regions observe specific local or religious bank holidays that aren't listed as national.
→ The MCP provides comprehensive data covering public, bank, and religious days. Don't forget to ask for all types of non-working days.
Ignoring Scope Validation
Running a date query for a country that isn't on the list, only to get an error because your initial assumptions about supported regions were wrong.
→
Always call list_supported_countries first. This validates your operational scope before running any time-intensive date checks.
When It Fits, When It Doesn't
Use this MCP if you need to know when people are actually working in a specific country or region, and the holidays involved are standard public, bank, or religious festivals. It's perfect for scheduling, supply chain timing, and global campaign planning.
Don't use it if your constraints involve highly localized academic breaks (like university semester closures) or complex labor agreements that aren't generally recognized as 'public.' For those niche rules, you still need to consult a local expert. However, for 90% of international scheduling problems involving standard calendar events, this tool is the definitive answer.
Common Questions About Calendarific MCP
Can I see all holidays in Brazil for 2024? +
Yes! Use the get_holidays tool with the country 'BR' and the year 2024. It will return a full list of public and bank holidays.
How do I find the ISO code for a country? +
Use the get_countries tool. It returns a comprehensive list of all supported countries along with their 2-letter ISO codes (e.g., 'US', 'FR', 'JP').
Does this include religious holidays like Easter? +
Yes. Calendarific tracks national, bank, and religious holidays. You can identify the type of holiday in the metadata returned by the tools.
What inputs does the `get_holidays` tool require? +
It requires a country code and a year. The agent needs these two pieces of information to fetch the holiday list. You pass the ISO code (e.g., 'US') and the four-digit year directly when you call this function.
If I run `get_holidays` with an unsupported country, what happens? +
The agent returns a specific error detailing the invalid code or format. This prevents bad data from entering your workflow. You'll get clear feedback on exactly which input needs correcting.
Does `list_supported_countries` handle regional variations? +
It lists all country codes recognized by the Calendarific service, not just political boundaries. This list includes specific regions that have unique public holiday calendars you might need.
Is my API key secure when running tools like `get_holidays`? +
Yes, your credentials pass through a zero-trust proxy and are never stored on disk. Vinkius handles the connection securely, meaning your keys only exist in transit.
Are there usage limits when repeatedly calling `get_holidays`? +
The API provider sets rate limits that you must respect. The platform helps manage these calls to prevent overspending and ensures the agent doesn't exceed your established budget.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.