Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http celestine https://celestine--bouch.run.tools
Open on GitHub

What 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.tools

Step 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.

Similar MCP servers

All MCP servers for AI and ML →

Project sponsors

Companies that keep this analytics open