Telugu Calendar Utilities MCP Server

Telugu Panchangam Calendar Feeds

Subscribable Telugu Panchangam feeds for 22 cities — delivered as .ics files you can add to Google Calendar, Apple Calendar, or Outlook.

Every day appears as an all-day event (no calendar blocking) with full Panchangam details in the description. Festival days — Ugadi, Vinayaka Chavithi, Deepavali, Maha Shivaratri, the Sankranti cluster, and 30+ more — are marked with 🪔 in the title; other special days (Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, Eclipses) with ⚡.

Subscribe

Visit the landing page to pick your city and calculation system and copy your webcal:// URL:

panchangam.astrochaganti.com

The site is also a daily toolkit: Today's Panchangam (any date, any city), Tarabalam · Muhurtam (good days and ranked time slots for up to four people by birth star, with Chandrabalam), and the Gochara chart with Rasi Phalalu (South Indian chart, transit verdicts and a computed daily reading). Everything is shareable to WhatsApp.

What's in each day's event

• Metadata — Samvatsara, Maasam, Paksham, Vaaram, solar and lunar signs
• Pancha Anga — Tithi, Nakshatra, Yoga, Karana with start/end times
• Sky markers — Sunrise, Sunset, Moonrise, Moonset
• Auspicious windows — Brahma Muhurta, Abhijit Muhurta, Amrita Kalam
• Inauspicious windows — Rahu Kalam, Gulika Kalam, Yamagandam, Varjyam, Durmuhurtham
• Choghadiya — 8 day blocks with names
• Eclipses — Solar and lunar eclipses with type (Total/Partial/Annular/Penumbral), visibility from your city, eclipse window, and Sutak period
• Special Yogas — Sarvartha Siddhi, Amrita Siddhi, Visha, and Dagdha yogas based on weekday/tithi/nakshatra combination

Cities

Telugu Heartland — Hyderabad, Vijayawada, Visakhapatnam, Tirupati, Warangal, Guntur, Nizamabad, Rajahmundry, Kurnool, Nellore

Major Indian Metros — Bengaluru, Chennai, Mumbai, Delhi

International Diaspora — Dallas, San Jose, San Francisco, Edison (NJ), New York, London, Sydney, Dubai

Calculation Systems

MCP Server

mcp-server-panchangam is available on PyPI. It's a standard MCP stdio server (uvx mcp-server-panchangam), so it works with any MCP-compatible client or agent — Claude Desktop, Claude Code, Cursor, Windsurf, and custom agents built on the MCP SDK. Below are examples for a couple of common clients; for others, point your client's MCP config at the same uvx mcp-server-panchangam command.

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "panchangam": {
      "command": "uvx",
      "args": ["mcp-server-panchangam"]
    }
  }
}

Claude Code — run once:

claude mcp add panchangam -- uvx mcp-server-panchangam

Available tools

All tools accept any free-text city name. Pre-configured cities resolve instantly; any other city is geocoded via OpenStreetMap. You can also pass latitude, longitude, and timezone directly.

How it works

Feeds are generated on the 1st of every month via GitHub Actions, covering 18 months ahead. They are served as static .ics files from GitHub Pages — zero hosting cost.

GitHub Actions (monthly cron)
  → python -m telugu_panchangam.generate   (22 cities × 3 systems = 66 feeds)
  → feeds/*.ics
  → GitHub Pages (webcal:// subscriptions)

Development

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
pytest tests/ -v
python -m telugu_panchangam.generate   # writes to feeds/