How do I use mcp-ukrainian-calendar?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-ukrainian-calendar What holiday is it today in Ukrainian paganism?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-ukrainian-calendar by ChuprinaDaria

╔══════════════════════════════════════════════════════════════╗
║  ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦  ║
║  · ◆ ·       U K R A I N I A N   C A L E N D A R       · ◆ · ║
║  ✦ · ✦ ·           M C P   S E R V E R             · ✦ · ✦  ║
║  · ◆ · ◆ ·   ─────────────────────────────────   · ◆ · ◆ ·  ║
║  ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦ · ✦  ║
╚══════════════════════════════════════════════════════════════╝

Ukrainian pagan calendar as an MCP server — holidays, deities, folk wisdom, and birth charms.

Сервер MCP з українським язичницьким календарем — свята, боги, народна мудрість, обереги.

Features


🗓 120 pagan holidays	Full calendar with traditions, rituals, and preparation guides
⚡ 184 deities	Ukrainian/Slavic pantheon from the Voytovych encyclopedia
🌾 365 folk wisdoms	Daily weather proverbs and agricultural sayings
🔮 8 birth charm periods	Personal patron deity based on your birthday
🇺🇦 Ukrainian language	All content in Ukrainian — authentic and unabridged
📦 Zero extra dependencies	Only the MCP SDK. No bloat.

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ukrainian-calendar": {
      "command": "npx",
      "args": ["-y", "mcp-ukrainian-calendar"]
    }
  }
}

Claude Code (CLI)

claude mcp add ukrainian-calendar -- npx -y mcp-ukrainian-calendar

Cursor

Add to your Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "ukrainian-calendar": {
      "command": "npx",
      "args": ["-y", "mcp-ukrainian-calendar"]
    }
  }
}

Tools

Tool	Description	Parameters
`get_today_holiday`	Holidays for today or a specific date, with traditions and rituals	`date?` — DD.MM format
`get_upcoming_holidays`	List of upcoming holidays in the next N days	`days?` — 1–365 (default 7)
`get_holiday_details`	Full details for a holiday by name or slug	`query` — name or slug
`search_holidays`	Search holidays by keyword across name, description, traditions	`query` — search text
`get_season_holidays`	All holidays for a given season	`season` — winter/spring/summer/autumn
`get_deity`	Info about a deity or mythological figure	`query` — name or slug
`search_deities`	Search deities by name or filter by group	`query?`, `group?`
`get_folk_wisdom`	Daily folk proverb for today or a specific date	`date?` — DD.MM format
`get_charm`	Personal birth charm with patron deity and ornament	`birthday` — DD.MM format

Deity groups: supreme · warrior · fertility · underworld · nature · household

Example Prompts

Holidays & Calendar

What Ukrainian pagan holidays are coming up this week?

Tell me about Купало — traditions, rituals, how to prepare.

What holidays are celebrated in Ukrainian paganism during winter?

Search for holidays related to fire in Ukrainian tradition.

Deities & Mythology

Who is Перун? Tell me about this deity.

List all deities of the underworld in Ukrainian mythology.

Who are the household deities in Slavic tradition?

Folk Wisdom & Charms

What does Ukrainian folk wisdom say about today's weather?

What is the folk proverb for March 25th?

I was born on 15.08 — what is my birth charm and patron deity?

Data Sources

All content is based on Valerii Voytovych's encyclopedic work on Ukrainian mythology, supplemented by traditional folk calendar materials. The deity database contains 184 figures from the Ukrainian/Slavic pantheon with descriptions faithful to the source.

Войтович В. Українська міфологія — the authoritative reference for Ukrainian pre-Christian beliefs, deities, and ritual tradition.

License

MIT — use freely, attribute kindly.

Built for the curious, the rootseekers, and those who wonder what their ancestors celebrated.

◆ · ✦ · ◆ · ✦ · ◆ · ✦ · ◆ · ✦ · ◆

👾 Created by Daria Chuprina · just because she can!

Threads · LinkedIn · Lazysoft · info@lazysoft.pl

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

mcp-ukrainian-calendar