Connect gethumandesign to your AI

MCP Server Documentation

The GetHumanDesign MCP server lets AI assistants calculate Human Design bodygraph charts, save people to your account, and explore designs through conversation. It connects to Claude, and any other AI assistant that supports the Model Context Protocol.

Works with

Claude

Claude Code

Gemini CLI

ChatGPT

Codex

Yours

Wait, what is human design?

Human Design is a self-knowledge system that combines astrology, the I Ching, Kabbalah, and the chakra system into a single chart called a bodygraph. Based on your exact birth date, time, and place, it maps out your energy type, decision-making authority, and personality profile — giving you a practical framework for understanding how you operate and interact with others.

Setup

Connect your favorite AI:

Click + in the sidebar
Select Connectors
Click Manage Connectors
Click + → Add custom connector
Fill in the fields:
Name
```
gethumandesign
```
Remote MCP Server URL
```
https://api.gethumandesign.com/mcp
```

Click + in the sidebar
Select Connectors
Click Manage Connectors
Click + → Add custom connector
Fill in the fields:
Name
```
gethumandesign
```
Remote MCP Server URL
```
https://api.gethumandesign.com/mcp
```

View docs ↗

Run the following command in your terminal.

claude mcp add --transport http gethumandesign https://api.gethumandesign.com/mcp

View docs ↗

Google does not yet support adding MCP servers in Gemini Web.

Run the following command in your terminal.

gemini mcp add --transport http gethumandesign https://api.gethumandesign.com/mcp

View docs ↗

Requires a paid ChatGPT plan (Plus, Pro, or Team).

Go to Settings → Connectors
Scroll down and click Advanced Settings
Enable Developer mode
Go back to Settings → Connectors and click Create in the Browser Connectors
Add a custom connector with MCP Server URL:
```
https://api.gethumandesign.com/mcp
```
To use it in a chat, click + then More and select the connector.

View docs ↗

Add the following to your Codex CLI MCP config. See the docs for the exact file location.

{
  "mcpServers": {
    "gethumandesign": {
      "url": "https://api.gethumandesign.com/mcp"
    }
  }
}

View docs ↗

Any AI that supports MCP servers can connect using the URL below. Check your AI's documentation for how to add a custom MCP server.

https://api.gethumandesign.com/mcp

Features

Chart calculation — Calculate a complete Human Design bodygraph for any birth date, time, and place. Returns type, authority, profile, defined centers, channels, and planetary activations.
Saved people — Save family and friends to your account so you can retrieve their charts by name without re-entering birth data.
Personal chart — Mark one person as "me" to quickly access your own design with a simple question like "what is my type?"
Free and Pro tiers — Free accounts get 15 requests per month and can save up to 2 people. Pro accounts get 300 requests per month with up to 10 people, plus advanced chart details (color, tone, base).

Authentication

The server uses OAuth 2.0. When you connect for the first time, you'll be redirected to sign in with your GetHumanDesign account (email + password or Google sign-in).

Free plan: 15 requests per month, up to 2 saved people.
Pro plan: 300 requests per month, up to 10 saved people, plus advanced chart details.

Manage your plan and usage at gethumandesign.com/dashboard.

Tools

The server exposes six tools:

get_bodygraph — Calculate a chart from birth datetime and place.
get_my_design — Get the chart for the account holder (the "this is me" person).
get_person_design — Get the chart for a saved person by name.
list_people — List all saved people in your account.
save_person — Save a person's birth data for later retrieval.
remove_person — Remove a saved person by name.

Tool Annotations

Each tool declares MCP tool annotations that tell your AI client what kind of side-effects to expect. The three annotations used by this server are:

readOnlyHint: When true, the tool only reads data and never creates, updates, or deletes anything.
destructiveHint: When true, the tool may irreversibly delete or overwrite data.
openWorldHint: When true, the tool interacts with external services (geocoding API, database) beyond the AI client itself.

Tool	readOnly	destructive	openWorld	Notes
`get_bodygraph`	true	false	true	Read-only chart calculation; calls external geocoding service and records usage metrics in external database.
`get_my_design`	true	false	true	Retrieves the authenticated user's saved chart; reads from external database and calls external geocoding service.
`get_person_design`	true	false	true	Retrieves a saved person's chart by name; reads from external database and calls external geocoding service.
`list_people`	true	false	true	Lists saved people from external database; no modifications made.
`save_person`	false	false	true	Creates a new person record in external database.
`remove_person`	false	true	true	Permanently deletes a person record from external database.

Examples

Ask about your own design

"What is my Human Design type?"

Uses get_my_design to fetch your chart and tell you your type, authority, and profile.

Calculate a chart for someone

"Calculate a Human Design chart for someone born April 10, 1985 at 2:30 PM in Montreal"

Uses get_bodygraph to compute and return the full bodygraph.

Save a person and explore their chart

"Save my partner John, born March 5 1990 at 8:00 AM in London, then show me his chart"

Uses save_person to store John's birth data, then get_person_design to retrieve and display his chart.

Compare charts

"Compare my design with John's — what channels do we share?"

Uses get_my_design and get_person_design to fetch both charts and analyze the overlap.

Privacy

We only collect the data needed to provide the service: your email for authentication and birth data for chart calculations. We do not sell your data or use it for advertising. Read our full Privacy Policy.

Support

Questions or issues? Email us at [email protected].