Log inSubmit server
W8s Astro MCP logo

W8s Astro MCP

Astrology MCP server for natal charts, transits, forecasting, history, and relationship charts stored in SQLite.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install W8s Astro MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "w8s-astro-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "w8s-astro-mcp",
        "w8s-astro-recalculate"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

w8s-astro-mcp MCP server calculates natal charts, transits, event charts, electional windows, and relationship charts using Swiss Ephemeris data. It stores profiles, charts, and transit lookup history in a local SQLite database, with support for composite and Davison charts. Install it with uvx or pip and connect it to Claude Desktop or another MCP-compatible client. Reach for it when an agent needs persistent astrology data, chart comparisons, transit research, or time-based forecasting.

Use cases

  • Create and inspect natal charts
  • Track current and historical transits
  • Compare profiles with relationship charts
  • Cast event and electional charts
  • Search stored astrology lookup history

Key features

  • Swiss Ephemeris planetary calculations
  • Persistent SQLite chart and transit history
  • Multi-profile chart management
  • Composite and Davison relationship charts
  • Transit timing and house-placement analysis
  • Event and electional chart scanning

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

5/5 checks healthy over the last 45d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · w8s-astro-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit12d agoMost recent push to the default branch.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How W8s Astro MCP works

What w8s-astro-mcp does

The w8s-astro-mcp MCP server provides astrology tools for creating and querying natal charts, tracking transits, casting charts for events, and examining relationships between profiles. It uses planetary-position calculations from Swiss Ephemeris through the pysweph package. Profiles can represent yourself, relatives, friends, or other people whose birth information you want to compare.

The server supports natal chart views, current and future transit analysis, composite charts, Davison charts, and placement of the current sky within a selected chart's houses. It also records transit lookups in SQLite, allowing later searches by date, planet, or sign. Electional features can scan a time window for conditions such as a direct Mercury or a non-void Moon when those criteria are requested.

How it works

w8s-astro-mcp MCP server runs as a local MCP process and communicates with an MCP client over its configured command. The recommended launch method uses uvx, which retrieves the PyPI package and runs it in an isolated environment. A normal pip installation is also supported.

Chart inputs include local birth or event date and time plus a location. The server uses the location's timezone when processing birth, event, and electional times. By contrast, the time supplied to get_transits, find_house_placements, and compare_charts is Universal Time.

After creating profiles, you can designate an owner profile. Tools then use that profile by default unless another person or connection is specified. Relationship calculations require a group of at least two people.

Setup and configuration

Install Python 3.10 or newer. For the recommended setup, add a Claude Desktop MCP entry with uvx as the command and w8s-astro-mcp as its argument, then restart the client. Alternatively, install the package with pip and invoke w8s-astro-mcp directly.

The default database is stored under ~/.w8s-astro-mcp/astro.db on macOS and Linux, or under %USERPROFILE%\\.w8s-astro-mcp\\astro.db on Windows.

If upgrading an old installation, the project provides a migration script for the owner-profile column. Releases affected by the timezone issue can be repaired with w8s-astro-recalculate; its dry-run mode previews changes, while --apply backs up the database before recalculating. Saved event charts can be included with --events.

Tools and capabilities

The documented use cases cover these operations:

  • Create profiles and display natal charts.
  • Retrieve current, upcoming, or historical transits.
  • Distinguish applying and separating transit aspects and estimate exactness timing.
  • Search stored transit lookups by date, planet, or sign.
  • Compare profiles through synastry, composite charts, and Davison charts.
  • Place current planetary positions in natal or relationship-chart houses.
  • Cast charts for past or planned events.
  • Scan future periods for requested electional conditions.

Transit readings can optionally return JSON output, which may help clients that need structured results instead of prose.

Limitations and notes

The project requires an MCP-compatible client and does not document client-specific behavior beyond the Claude Desktop setup.

Stored data is local SQLite data, so profiles and lookup history are tied to the machine running the server. Users upgrading from versions before 0.12 should run the owner-profile migration, while users upgrading to the affected newer release should review and, if needed, recalculate stored charts.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about W8s Astro MCP

w8s-astro-mcp is an MCP server that connects an MCP-compatible AI client to local astrology profiles and a SQLite database. Its main tools cover natal charts, transit lookups and forecasts, event and electional charts, history searches, house placements, and composite or Davison relationship charts calculated with Swiss Ephemeris.

Install it with uvx or pip. The recommended method adds `uvx` with `w8s-astro-mcp` as its argument to the Claude Desktop MCP configuration; alternatively, run `pip install w8s-astro-mcp` and use the installed command.

It stores data in a local SQLite database at `~/.w8s-astro-mcp/astro.db` on macOS and Linux, and at `%USERPROFILE%\.w8s-astro-mcp\astro.db` on Windows. The stored data includes profiles, charts, and transit lookup history.

Yes. It supports synastry-style comparisons as well as composite and Davison charts for connections containing two or more people. It can also place the current sky in a relationship chart's house system.

The README confirms Claude Desktop and any MCP-compatible client, but it does not specifically name Cursor. The server is launched as a local MCP process with `uvx` or its installed command.

Related MCP servers

All in Spirituality & Esoterica All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewW8s Astro MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/w8s-astro-mcp?style=directory)](https://allmcps.com/mcp/w8s-astro-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/w8s-astro-mcp"><img src="https://allmcps.com/api/badge/w8s-astro-mcp?style=directory" alt="W8s Astro MCP on AllMCPs" /></a>