Gevety
Connect Gevety to ChatGPT
Build a custom GPT that knows your health data. Query biomarkers, get personalized insights, and track trends—all through natural conversation.
Prerequisites
- A Gevety account with uploaded lab results
- An API token from your Developer Settings
- ChatGPT Plus subscription (required for Custom GPTs with Actions)
1
Generate Your API Token
Your API token authenticates your Custom GPT's requests to the Gevety API.
- Go to Profile → Developer Settings
- Click "Generate New Token"
- Copy and securely store your token
Important: You'll need to paste this token into your Custom GPT's authentication settings. Keep it secure and don't share it publicly.
2
Create a New Custom GPT
- Go to chat.openai.com/gpts/editor
- Click "Create a GPT"
- Give it a name like "My Health Assistant" or "Gevety Health Coach"
- Add a description explaining it can access your health data
Suggested Instructions:"You are a health assistant with access to my Gevety health data. Help me understand my biomarkers, track trends, and provide actionable health insights. Always cite specific data points when making recommendations."
3
Add the Gevety API Action
Actions let your GPT call external APIs. Here's how to add the Gevety API:
- In the GPT editor, scroll down to "Actions" and click "Create new action"
- Copy and paste the OpenAPI schema below
- Click "Authentication" and select "API Key"
- Set Auth Type to
Bearer - Paste your Gevety API token
OpenAPI Schema
openapi.json
{
"openapi": "3.0.0",
"info": {
"title": "Gevety Health API",
"version": "1.0.0",
"description": "Access your Gevety health data including biomarkers, wearable stats, and health scores"
},
"servers": [
{
"url": "https://api.gevety.com"
}
],
"paths": {
"/api/v1/mcp/tools/get_health_summary": {
"get": {
"operationId": "getHealthSummary",
"summary": "Get overall health score and summary",
"description": "Returns overall health score, status, axis scores, and top concerns",
"responses": {
"200": {
"description": "Health summary data"
}
}
}
},
"/api/v1/mcp/tools/query_biomarker": {
"get": {
"operationId": "queryBiomarker",
"summary": "Get specific biomarker data",
"description": "Returns current value, history, trends, and optimal ranges for a biomarker",
"parameters": [
{
"name": "biomarker",
"in": "query",
"required": true,
"schema": { "type": "string" },
"description": "Biomarker name (e.g., vitamin d, cholesterol, hemoglobin a1c)"
}
],
"responses": {
"200": {
"description": "Biomarker data and history"
}
}
}
},
"/api/v1/mcp/tools/get_wearable_stats": {
"get": {
"operationId": "getWearableStats",
"summary": "Get wearable device statistics",
"description": "Returns sleep, activity, and heart rate data from connected wearables",
"parameters": [
{
"name": "days",
"in": "query",
"schema": { "type": "integer", "default": 7 },
"description": "Number of days of data to return"
}
],
"responses": {
"200": {
"description": "Wearable statistics"
}
}
}
},
"/api/v1/mcp/tools/get_biological_age": {
"get": {
"operationId": "getBiologicalAge",
"summary": "Get biological age breakdown",
"description": "Returns calculated biological age and contributing factors",
"responses": {
"200": {
"description": "Biological age data"
}
}
}
},
"/api/v1/mcp/tools/list_supplements": {
"get": {
"operationId": "listSupplements",
"summary": "Get supplement stack",
"description": "Returns current supplements with dosing and timing",
"responses": {
"200": {
"description": "Supplement list"
}
}
}
},
"/api/v1/mcp/tools/get_upcoming_tests": {
"get": {
"operationId": "getUpcomingTests",
"summary": "Get recommended tests",
"description": "Returns upcoming blood tests and their urgency",
"responses": {
"200": {
"description": "Upcoming tests list"
}
}
}
}
},
"components": {
"securitySchemes": {
"bearerAuth": {
"type": "http",
"scheme": "bearer"
}
}
},
"security": [
{
"bearerAuth": []
}
]
}4
Test Your GPT
Once configured, test your GPT with these example questions:
"What's my current vitamin D level?"
"How has my cholesterol changed over the past year?"
"What's my biological age?"
"What tests am I due for?"
The GPT will call the Gevety API and provide responses based on your actual health data.
Available API Endpoints
Your Custom GPT can access these endpoints through the schema above:
getHealthSummaryOverall health score and key metricsgetBiomarkerSpecific biomarker data and historygetWearableStatsSleep, activity, and heart rate datagetBiologicalAgeCalculated biological age breakdownlistSupplementsCurrent supplement stackgetUpcomingTestsRecommended tests and urgencyTroubleshooting
"Action failed" or "Unable to connect"
- Verify your API token is correct and hasn't expired
- Check that Authentication is set to "API Key" with "Bearer" type
- Make sure the token is pasted without extra spaces
- Generate a new token from Developer Settings
GPT doesn't use the API
- Add instructions that specifically mention using the Gevety API
- Try prompting explicitly: "Use the Gevety API to check my..."
- Verify the schema was imported correctly in the Actions section
Missing or empty data
- Ensure you've uploaded lab results to your Gevety account
- Check the biomarker name spelling (use hyphens: "vitamin-d" not "vitamin d")
- Some endpoints require connected wearables for data
Privacy Note: When you use a Custom GPT with the Gevety API, your health data is sent to OpenAI's servers to generate responses. Your API token only grants access to your own data, and you can revoke it anytime from Developer Settings.
Related Integrations
Ready to Build Your Health GPT?
Generate your API token from Developer Settings and start building your personalized health assistant today.