Telugu Panchangam MCP Server
socraticsurge/telugu-calendar-utilities
Calendário astrológico Telugu com muhurtam e festivais para assistentes IA
Ver no GitHubServidor MCP que fornece dados astrológicos hindus (Panchangam) para 22 cidades em três sistemas de cálculo (Drik Ganita, Surya Siddhanta, Vakya). Integra-se nativamente com Claude e oferece feeds `.ics` para calendários com tithis, nakshatras, muhurtams, eclipses e 30+ festivais.
Instalação
npx convez-ai socraticsurge/telugu-calendar-utilities1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar calendários astrológicos hindus em aplicações Claude
- Consultar datas auspiciosas e janelas de muhurta programaticamente
- Sincronizar festivais e eventos astronômicos com Google Calendar ou Apple Calendar
- Construir ferramentas de astrologia tradicional com cálculos precisos
Veredito

Solução robusta e bem documentada para astrologia hindu com suporte MCP nativo. Raro encontrar implementação tão precisa de Panchangam em código aberto; recomendado para aplicações que precisem de dados astrológicos ou calendários culturais indianos.
README
A tradução para o português deste README ainda está na fila.
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:
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
| System | Basis | Best for |
|---|---|---|
| Drik Ganita | Swiss Ephemeris (pyswisseph) + Lahiri ayanamsa | Modern apps, accurate sky events |
| Surya Siddhanta | Mean-motion algorithms from classical SS text | Traditions rooted in classical siddhantic calculation |
| Vakya | Surya Siddhanta + published correction tables | Traditional Telugu/Tamil printed Panchangams |
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
| Tool | Description |
|---|---|
list_supported_cities | 22 pre-configured cities with lat/lon/timezone |
get_panchangam | Full Panchangam for any date and city |
get_muhurta | One day's auspicious/inauspicious windows (see find_muhurta to search across days) |
get_special_days | Named festivals, Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, Ganda Moola, and Eclipses for a month |
find_tarabalam_days | Tarabalam & Chandrabalam — days favourable for 1–4 people by birth star (and rashi), with selectable strictness |
get_graha_positions | All nine grahas at sunrise — rasi, nakshatra, retrograde, next-rasi ingress dates |
get_gochara | Gochara verdicts from a janma rashi — Brihat Samhita houses, vedha, Sade Sati / Ashtama Shani |
get_rasi_phalalu | Daily Rasi Phalalu — deterministic daily reading rendered from computed facts |
find_muhurta | Ranked auspicious time slots — activity-aware, every slot with its reasons |
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/