celestine — Claude Code MCP server: astrological calculations
celestine — an MCP server for astrological calculations: natal charts, transits, progressions, planetary positions, and aspect calendars.
no license 2,188 installs updated 2026-04-29
claude mcp add --transport http celestine https://celestine--bouch.run.toolsWhat celestine does
The server performs astrological calculations through Swiss Ephemeris: builds natal charts with planets, houses, aspects, and patterns, computes current transits and searches transits in a given period, calculates secondary progressions and solar arc, returns planetary positions for any date. Reference tools for signs, houses, planets, and aspects are included.
birth_chart with detail="compact" drops per-aspect details and per-pattern planet lists, keeping only summary counts. current_transits in mode="summary" returns the six strongest transits and aggregate counts in roughly 800 tokens; mode="full" gives all active transits, around 4 thousand tokens. transit_search finds transits in a period and groups them by body and aspect type; mode="top" adds the N strongest transits with enter, exact, and leave-orb dates.
generate_calendar_events produces calendars of sabbats, Moon phases, retrograde stations, ingresses, or transits. The server uses Swiss Ephemeris; standalone calculations in code_interpreter without this library will produce incorrect dates.
What it helps with
- build a natal chart with aspects and houses
- find active transits for the current date or a period
- calculate secondary progressions and solar arc
- generate a calendar of retrogrades, Moon phases, and ingresses
- get planetary positions for an arbitrary date
Example prompts for the agent
- Build a natal chart for March 15, 1985, 2:30 PM, Moscow
- What transits are active right now for this chart?
- Find all Saturn transits to natal Sun in April 2025
How to install celestine
Platform CLI: remote server
claude mcp add --transport http celestine https://celestine--bouch.run.toolsPlatform CLI: remote server
codex mcp add celestine --url https://celestine--bouch.run.toolsConfig file
{
"mcpServers": {
"celestine": {
"url": "https://celestine--bouch.run.tools"
}
}
}Config file
{
"servers": {
"celestine": {
"type": "http",
"url": "https://celestine--bouch.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http celestine https://celestine--bouch.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about celestine
How to install celestine in Claude Code?
Run claude mcp add --transport http celestine https://celestine--bouch.run.tools.
What does celestine do?
The MCP server performs astrological calculations: builds natal charts, computes transits and progressions, returns planetary positions, and generates aspect calendars.
What is the difference between summary and full modes in current_transits?
summary returns the six strongest transits and counts in 800 tokens, full gives all active transits in roughly 4 thousand tokens.