Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Human Design

FreeNot checked

Compute Human Design charts, cycle returns, transits, synthesis, and chart comparison natively inside AI assistants.

GitHubEmbed

About

Compute Human Design charts, cycle returns, transits, synthesis, and chart comparison natively inside AI assistants.

README

npm version license: MIT Human Design MCP

Compute Human Design charts, cycle returns, transits, synthesis, and chart comparison natively inside your AI assistant — powered by Simple Chart Calculator. Sub-second precision, built on Swiss Ephemeris. 9 tools.


⚡ Fastest: remote connector — no install at all

Works in Claude on the web, desktop and Cowork (and any MCP client that supports remote servers). In Claude: Settings → Connectors → Add custom connector, then paste your personal URL:

https://api.simplechartcalculator.com/mcp/YOUR_API_KEY

Get a free key (and your ready-made personal URL) at https://simplechartcalculator.com/portal. The URL contains your key — treat it like a password. The remote connector exposes the 5 calculation tools; the local install below adds a private on-device people roster.


✅ Local install — one click (Claude Desktop)

No config files, no terminal.

  1. Download Human-Design-SimpleChartCalculator.mcpb.
  2. Double-click it (or open Claude Desktop → Settings → Extensions → Install… and pick the file).
  3. When asked, paste your API key in the box. No key yet? Get a free one at https://simplechartcalculator.com/register (30 seconds, no card). Keep the key private — it counts against your plan.
  4. Done. Just chat (see Example prompts below).

Other clients (Cursor, Cline) — config file

If you're not on Claude Desktop, add the server to your MCP config manually:

{
  "mcpServers": {
    "human-design": {
      "command": "npx",
      "args": ["-y", "@simplechart/mcp"],
      "env": { "SCC_API_KEY": "YOUR_KEY" }
    }
  }
}
  • Cursor: ~/.cursor/mcp.json (or Settings → MCP → Add Server)
  • Cline: MCP Servers → Configure

The npx @simplechart/mcp command needs the package published to npm. The one-click .mcpb above is fully self-contained and works without npm.

Tools (9)

Tool What it does
calculate_chart Full bodygraph from birth data — type, authority, profile, centers, channels, all 14 planets as gate.line.color.tone.base.
get_synthesis The interpretive layer — strategy, signature, not-self, incarnation cross, variables.
calculate_cycle Exact Solar / Saturn / Uranus-opposition / Chiron return moment (sub-second) + the chart for it.
get_transit The live global transit chart right now.
compare_charts Connection dynamics between two people — electromagnetic, dominance, compromise & companionship channels.
save_person Save birth data locally on your machine (~/.simplechart-mcp/people.json) to recall or compare by name.
get_person Recall a saved person's full chart by name.
list_people List everyone in your local roster.
remove_person Delete someone from your roster.

Your saved people live in a local JSON file on your own machine — nothing is stored on our servers.

Example prompts

Once installed, just ask your assistant in plain language:

"Calculate the Human Design chart for Ra Uru Hu, born 9 April 1948 at 00:05 in Montreal."

"When was Ra Uru Hu's first Saturn return? Born 9 April 1948, 00:05, Montreal."

"Save my mum's birth data, then compare her chart with mine."

"What's the current Human Design transit?"

Environment variables

Var Required Default
SCC_API_KEY yes
SCC_API_BASE no https://api.simplechartcalculator.com

The free tier includes 300 calls/month (6 via MCP). Pro ($33/mo) includes 25,000 calls, full synthesis data and 600 MCP calls.

License

MIT © Simple Chart Calculator

from github.com/simplechartcalculator/human-design-mcp

Install Human Design in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install human-design-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add human-design-mcp -- npx -y @simplechart/mcp

FAQ

Is Human Design MCP free?

Yes, Human Design MCP is free — one-click install via Unyly at no cost.

Does Human Design need an API key?

No, Human Design runs without API keys or environment variables.

Is Human Design hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Human Design in Claude Desktop, Claude Code or Cursor?

Open Human Design on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Human Design with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All design MCPs