How to Use the Calendarific MCP in Claude

Pull global holiday data directly into Claude Desktop for scheduling, planning, and global team coordination.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Calendarific MCP to Claude Desktop

Create your Vinkius account to connect Calendarific to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Calendarific with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Global Holiday Tracking via MCP Server

The `list_holidays` tool pulls precise public and religious observances for over 230 countries directly into your chat. Instead of leaving your window to search for international banking days, your AI client fetches the exact dates you need. You ask about Q3 availability in Japan, and it cross-references the calendar immediately. Planning regional events requires local context. Calling `list_holidays_by_location` isolates state-specific observances, so you avoid scheduling a major launch during a local festival in Bavaria or Quebec. Everything happens inside the conversational interface you already use.

Filter by Observance Type

Executing `list_holidays_by_type` categorizes dates into national, religious, or local observances. Your agent filters out minor events and only flags the days that actually close banks or halt shipping. You get exactly the data needed to build accurate project timelines. Checking integration health takes one step. The `get_account_info` tool verifies your MCP server connection status instantly. You never have to wonder if the data feed dropped right before building a critical quarterly roadmap.

Multilingual Country Indexing

Running `list_supported_countries` maps out every available region and its corresponding ISO code. Claude uses this reference to ensure it queries the exact geopolitical boundary you care about. Don't guess country codes or deal with mismatched API requests. Supporting global teams means respecting local languages. The `list_supported_languages` function returns the available dialects for holiday names. Your agent can generate a localized holiday schedule for your offshore team without needing a separate translation pass.

Setup guide

Set up Calendarific MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Calendarific MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Calendarific MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under calendarific-mcp.

json

{
  "mcpServers": {
    "calendarific-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Calendarific now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Calendarific MCP in Claude Desktop

Open Settings, go to Developer, and click Edit Config. Add the server details to your claude_desktop_config.json file. Save it and restart the application completely to see the tools appear.

Yes, the system handles regional data perfectly. You can target specific states or provinces to see local closures instead of just national events.

Your agent can run a quick diagnostic check. It uses a specific tool to verify your account and integration status immediately.

You can paste the Vinkius endpoint URL directly into the Custom Connectors section under Integrations. The web app will authenticate and connect without any local configuration files.

The system only pulls public holiday records and basic account status metrics. Vinkius isolates this execution inside a V8 sandbox, ensuring your prompts never leak into the broader internet. The connection is ephemeral and destroys itself after the query finishes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript