Calendarific Connector for AI agents.
2 live capabilities
Schedule international meetings and travel by checking global bank holidays.
Waiting for input…
Why people use Calendarific
Calendarific for Global Holiday Research
This Connector lets your agent do the digging for you. Just ask for the holidays in a specific country and your agent pulls the full list. You get a clear picture of regional availability without ever leaving your chat interface.
What Vinkius changes
Your agent handles the global calendar research so you can focus on actual planning.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
Scheduling a global sprint
A project manager asks the agent to find all bank holidays in the UK and France for 2025 to set a team deadline.
- Real-world use case 02
Planning a multi-country tour
A travel agent asks for a list of all public holidays in Italy to ensure a tour doesn't hit a major shutdown.
- Real-world use case 03
Regional marketing
An e-commerce lead asks for religious holidays in India to avoid running a sale on an observant day.
Complete set · 2capabilities
The complete Calendarific capability set.
These are the exact actions your AI can choose when you ask it to work with Calendarific.
01—02
2 capabilities in this set.
Part of 2 available through Calendarific.
- 01 Capability
Get holidays
Fetch all public and bank holidays for a specific country and year to check regional availability. Use this to see full yearly calendars for any nation.
- 02 Capability
List supported countries
Get a full list of supported countries and their ISO codes for global operations. This ensures you have the correct codes for every region.
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_R4cMekmSDiSSDuWvKyGG20vgUjQK3k5YIM5N6BZg/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_R4cMekmSDiSSDuWvKyGG20vgUjQK3k5YIM5N6BZg/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-alternative": {
"url": "https://edge.vinkius.com/vk_preview_R4cMekmSDiSSDuWvKyGG20vgUjQK3k5YIM5N6BZg/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...". 2 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"calendarific-alternative": {
"url": "https://edge.vinkius.com/vk_preview_R4cMekmSDiSSDuWvKyGG20vgUjQK3k5YIM5N6BZg/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...". 2 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"calendarific-alternative": {
"url": "https://edge.vinkius.com/vk_preview_R4cMekmSDiSSDuWvKyGG20vgUjQK3k5YIM5N6BZg/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...". 2 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"calendarific-alternative": {
"url": "https://edge.vinkius.com/vk_preview_R4cMekmSDiSSDuWvKyGG20vgUjQK3k5YIM5N6BZg/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...". 2 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add calendarific-alternative --transport http "https://edge.vinkius.com/vk_preview_R4cMekmSDiSSDuWvKyGG20vgUjQK3k5YIM5N6BZg/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...". 2 tools are ready
Where the request belongs
Work Calendarific can move forward.
This is for anyone who manages cross-border projects or plans international travel and needs to know when people are actually available to work or celebrate.
Project Manager
Checking regional availability for a 10-person team spread across three continents to set a realistic deadline.
Travel Planner
Mapping out a 14-day itinerary in Europe while avoiding major national shutdowns or bank holidays.
E-commerce Manager
Timing a global marketing launch so it doesn't land on a major religious holiday in a key target market.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse Connectors
Business Day Calculator
Calculate workdays, holidays, and business day ranges across 50+ countries.
Deadline Calculator
Calculate precise end dates by adding calendar or business days, accounting for weekends and regional holidays.
Calendar Converter
Convert dates between 15+ calendar systems including Gregorian, Chinese, Persian, and Japanese Era.
Days Between Dates Calculator
Calculate precise intervals between two dates in years, months, weeks, and days.
Calendarific
Access global holiday data via Calendarific. track public, religious, and local holidays across 230+ countries directly from any AI agent.
Nager.Date
Manage public holidays worldwide. audit global events and calendars via AI.
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 Calendarific MCP find holidays for my specific country?
Yes, it supports over 200 countries including major regions across every continent. Your agent can pull the full list of public and bank holidays for any of those locations.
Does it include religious holidays?
Yes, the data includes religious observances alongside national and bank holidays. This helps you avoid scheduling conflicts during important cultural events.
Can I check holidays for a specific year?
You can ask your agent to pull holidays for any specific year. This is great for long-term project planning or multi-year travel itineraries.
How do I get the API key for this Connector?
You can get your free API key directly from the Calendarific website. Once you have it, just add it to your AI client to start querying.
Can I use this for international business travel?
That is a primary use case. Your agent can identify bank holidays in your destination to ensure you aren't planning travel during a national shutdown.
Is this for my personal calendar?
No, this Connector is for retrieving public holiday data. It won't sync your personal appointments or private events.
Can it tell me the type of holiday?
Yes, it provides details on whether a day is a national, religious, or bank holiday. This helps you understand the context of a regional closure.
Can I see all holidays in Brazil for 2024?
Yes! Use the get_holidays capability 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 capability. 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 capabilities.
One connection away
Give your agent a direct line to Calendarific.
Connect Calendarific once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available