Calendarific Connector for AI agents.
6 live capabilities
Plan international travel and global schedules with accurate holiday data.
Waiting for input…
Why people use Calendarific
Calendarific for Global Holiday Planning
This Connector changes that by putting all those dates in your chat window. You just ask your agent for the holidays in a specific region and it gives you the answer immediately. You get a clear schedule without the manual research.
What Vinkius changes
You get instant access to global holiday data without leaving your chat window.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Planning a team offsite in Brazil
A user asks for public holidays in Brazil for 2024 to avoid booking travel during Carnival or other major closures.
- Real-world use case 02
Managing a global dev team
A project manager checks if the Tokyo office is closed for a local holiday before assigning a sprint deadline.
- Real-world use case 03
Building a travel app
A developer asks the agent for a list of all countries to populate a dropdown menu in their new application.
Complete set · 6capabilities
The complete Calendarific capability set.
These are the exact actions your AI can choose when you ask it to work with Calendarific.
01—03
3 capabilities in this set.
Part of 6 available through Calendarific.
- 01 Capability
Get account info
Check if your connection to the service is active. This ensures your API key is working correctly.
- 02 Capability
List holidays by location
Find holidays for a specific state or region within a country. This is useful for identifying local variations.
- 03 Capability
List holidays by type
Filter holidays by categories like national or religious. This helps you narrow down the specific types of dates you need.
04—06
3 capabilities in this set.
Part of 6 available through Calendarific.
- 04 Capability
List holidays
Get all holidays for a specific country and year. This provides a complete overview of the yearly calendar.
- 05 Capability
List supported languages
See which languages the data is available in. Use this to check for specific regional language support.
- 06 Capability
List supported countries
Get a full list of all countries and their ISO codes. Use this to see which nations are covered.
Set up in minutes
One URL. Then ask Calendarific to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Calendarific from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_l1UKd1aDzxlrDprsCz8S1H4eO9YTZT5Fr3lY2TJK/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Calendarific, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Calendarific for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_l1UKd1aDzxlrDprsCz8S1H4eO9YTZT5Fr3lY2TJK/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Calendarific URL.
- Step 03
Save and start
Save the connection and enable Calendarific in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"calendarific": {
"url": "https://edge.vinkius.com/vk_preview_l1UKd1aDzxlrDprsCz8S1H4eO9YTZT5Fr3lY2TJK/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Calendarific
Open Agent mode in chat and ask: "Using Calendarific, help me...". 6 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"calendarific": {
"url": "https://edge.vinkius.com/vk_preview_l1UKd1aDzxlrDprsCz8S1H4eO9YTZT5Fr3lY2TJK/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Calendarific
Ask Copilot: "Using Calendarific, help me...". 6 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"calendarific": {
"url": "https://edge.vinkius.com/vk_preview_l1UKd1aDzxlrDprsCz8S1H4eO9YTZT5Fr3lY2TJK/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Calendarific
Open Cascade and ask: "Using Calendarific, help me...". 6 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"calendarific": {
"url": "https://edge.vinkius.com/vk_preview_l1UKd1aDzxlrDprsCz8S1H4eO9YTZT5Fr3lY2TJK/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Calendarific
Ask Cline: "Using Calendarific, help me...". 6 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add calendarific --transport http "https://edge.vinkius.com/vk_preview_l1UKd1aDzxlrDprsCz8S1H4eO9YTZT5Fr3lY2TJK/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Calendarific
Ask Claude: "Using Calendarific, show me...". 6 tools are ready
Where the request belongs
Work Calendarific can move forward.
This is for the project manager coordinating a distributed team or the travel coordinator planning multi-country routes. It solves the headache of missing a local bank holiday that shuts down an entire office.
Operations Manager
Checks if international offices are open before scheduling meetings with global teams.
Travel Coordinator
Plans multi-country itineraries while accounting for local closures and regional holidays.
Software Developer
Pulls holiday data into applications via natural language queries to automate date logic.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsNager.Date
Manage public holidays worldwide. audit global events and calendars via AI.
Holiday API
Manage global holidays. audit public and federal holidays via AI.
Business Timezone & Holiday Scheduler
Eradicate LLM scheduling errors. Calculate exact business days skipping global public holidays and convert precise timezones flawlessly.
Business Day Calculator
Calculate workdays, holidays, and business day ranges across 50+ countries.
Calendarific
Universal holiday intelligence. get public, bank, and religious holidays worldwide via AI.
Deadline Calculator
Calculate precise end dates by adding calendar or business days, accounting for weekends and regional holidays.
Bring your own AI
Change the model, client or framework. Keep Calendarific connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Calendarific.
The practical details behind the request, access and result.
Can I use Calendarific MCP to find holidays in my specific state?
Yes, you can get holidays for specific states or regions to make sure you aren't missing local variations.
Does the Calendarific MCP cover all countries?
It provides holiday data for over 230 countries, including both public and religious dates.
Can I filter holidays by type?
Yes, you can ask for specific types like national holidays or religious observances to keep your results relevant.
How does Calendarific MCP help with international project management?
It lets you quickly check if international offices are closed, so you don't schedule meetings on local holidays.
Can I get descriptions for the holidays?
Yes, the Connector provides metadata including descriptions and the specific regions where the holidays are observed.
Is the data from Calendarific MCP updated for the current year?
Yes, you can query holidays for specific years to ensure your planning is accurate for the current or upcoming calendar.
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 capability 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 capability. It will retrieve the complete directory of over 230 countries currently available in the Calendarific API.
One connection away
Give your agent a direct line to Calendarific.
Connect Calendarific once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available