Skip to content
MCP server

Natal Chart Lab

Keyless MCP server for planet positions, retrogrades, Moon phases and birth placements

Runs locallyStatus and history
Pricing
Open source
Platforms
API, CLI
Runs
Locally
Version
1.0.0
Listing updated
2 days ago

About Natal Chart Lab

Natal Chart Lab is an open-source MCP server for astrology. It runs locally on your machine and is started by your AI client.

This is a thin client over the free Natal Chart Lab astrology API, so there is no key, sign-up or stored personal data. Positions are apparent geocentric longitudes on the tropical zodiac, calculated with Astronomy Engine and compared against NASA JPL Horizons. The README reports a largest difference of 19.5 arcseconds across 50 test points. The mean North Node and mean Black Moon Lilith are included.

Five tools cover the current sky, positions for any UTC time between 1800 and 2200, signs for a local birth date and time, and retrograde and Moon phase tables for 1950 to 2050. The current-sky call also reports Moon illumination, the next sign change, void-of-course windows for seven days, and each planet's retrograde or shadow status.

It does not compute rising signs or houses, and the README points to the site's birth chart calculator for those. The retrograde, Moon phase and eclipse tables are published under CC BY 4.0 and the server code is MIT licensed. A NATALCHARTLAB_URL variable lets you point it at another deployment of the same API.

Install

Run in a terminal

claude mcp add natalchartlab -- npx -y natalchartlab-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "natalchartlab": {
      "command": "npx",
      "args": [
        "-y",
        "natalchartlab-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "natalchartlab": {
      "command": "npx",
      "args": [
        "-y",
        "natalchartlab-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "natalchartlab": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "natalchartlab-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

get_current_sky
Returns Sun, Moon and planet signs now, Moon phase and void-of-course windows, and retrograde or shadow status.
get_planet_positions
Returns longitude, sign, degree, speed and retrograde flag for each body at any UTC time from 1800 to 2200.
get_birth_placements
Returns Sun, Moon and planet signs for a local birth date, time and UTC offset.
get_retrogrades
Lists retrogrades of Mercury to Pluto in a date range with station times and shadow dates.
get_moon_phases
Lists New Moons, quarters and Full Moons in a date range with sign, degree, distance and eclipses.

What it does

Current sky
Returns signs, Moon phase, illumination, void-of-course windows and retrograde status now.
Positions for any time
Gives sign, degree, speed and retrograde flag for bodies from 1800 to 2200.
Birth placements
Finds Sun, Moon and planet signs from a local birth date, time and UTC offset.
Retrograde tables
Lists Mercury to Pluto retrogrades with station times and shadow dates, 1950 to 2050.
Moon phase tables
Lists New, quarter and Full Moons with sign, degree, distance and eclipses.
No key needed
Runs through npx with no account or API key.

Good for

  • Check whether Mercury is retrograde and when the next one starts
  • Look up Sun, Moon and Venus signs for a birth date
  • List the Full Moons of a given year with their signs
  • Check if the Moon is void of course
  • Add live sky data to an astrology chatbot

Pricing

Open source

Free, no key; MIT licensed code and CC BY 4.0 data tables

Prices change. Check natalchartlab.com before you buy.

Natal Chart Lab FAQ

Does it need an API key?

No. The README says there is no key, sign-up or stored personal data.

Does it compute houses or a rising sign?

No. It returns planet signs only; the site's birth chart calculator handles houses.

How accurate are the positions?

They come from Astronomy Engine and match NASA JPL Horizons to within about 20 arcseconds.

What date ranges are covered?

Positions run 1800 to 2200; retrograde and Moon phase tables cover 1950 to 2050.

Is Natal Chart Lab free?

Yes. Natal Chart Lab is open source, so you can use and self-host it for free.

How do I add Natal Chart Lab to Claude Code?

Run this command in your terminal: claude mcp add natalchartlab -- npx -y natalchartlab-mcp

What are the best alternatives to Natal Chart Lab?

The closest alternatives to Natal Chart Lab are VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic), Céu Natal and OIYO Korea Calculators.

Alternatives to Natal Chart Lab

  1. AstroLogics

    MCP server

    Vedic astrology calculations for AI assistants: birth chart, dasha, panchang, matching

    • 23 tools
    • Remote
    • Freemium
    • Astrology
  2. Céu Natal

    MCP server

    Swiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese

    • 9 tools
    • Remote
    • Open source
    • Astrology
  3. Deterministic Korean tax, payroll, labor and calendar calculators served over MCP

    • 76 tools
    • Remote
    • Free
    • Finance and payments
  4. Moon phase, moonrise, eclipses and Moon sign for any date or city via MCP

    Not checked yet
    • 7 tools
    • Remote
    • Free
    • Astrology