Connect Gevety to Cursor IDE
Check your health stats while coding. Query biomarkers, track trends, and get personalized insights without leaving your development environment.
Prerequisites
- A Gevety account with uploaded lab results
- An API token from your Developer Settings
- Cursor IDE installed on your computer
- Python 3.10+ (for the MCP package)
Generate Your API Token
Your API token authenticates Cursor's requests to your Gevety health data.
- Go to Profile → Developer Settings
- Click "Generate New Token"
- Copy and save your token (it starts with
gvt_)
Install the Gevety MCP Package
Install the official Gevety MCP server package:
pip install gevety-mcpAlternatively, Cursor can run it directly with uvx (no install needed).
Configure Cursor
Add the Gevety MCP server to your Cursor configuration. Open Cursor's MCP settings:
- Open Cursor Settings (Cmd/Ctrl + ,)
- Search for "MCP" or navigate to Features → MCP Servers
- Click "Edit in settings.json" or add a new MCP server
Add the following configuration:
{
"mcpServers": {
"gevety": {
"command": "uvx",
"args": ["gevety-mcp"],
"env": {
"GEVETY_API_TOKEN": "your-token-here"
}
}
}
}your-token-here with your actual API token from Step 1.Restart Cursor
Restart Cursor to load the new MCP server configuration. After restarting, you should see "gevety" available in the MCP tools.
Example Queries
Try these questions while coding to check on your health:
Available Tools
The Gevety MCP server provides 11 tools for accessing your health data:
get_health_summaryOverall health score and key metricsquery_biomarkerSpecific biomarker data and historyget_wearable_statsSleep, activity, heart rate dataget_biological_ageCalculated biological age breakdownlist_supplementsCurrent supplement stackget_activitiesRecent exercise historyget_today_actionsDaily health tasksget_protocol90-day health protocolget_upcoming_testsRecommended lab testsget_opportunitiesHealth improvement areaslist_available_dataCheck what data is availableTroubleshooting
MCP server not appearing in Cursor?
- Verify your configuration JSON syntax is valid
- Check that Python 3.10+ is installed and in your PATH
- Try running
gevety-mcpin terminal to test - Restart Cursor completely (not just reload window)
Authentication errors?
- Verify your token starts with
gvt_ - Check that the token hasn't expired in Developer Settings
- Ensure no extra spaces or quotes around the token
- Try generating a fresh token
No health data returned?
- Ensure you've uploaded lab results to your Gevety account
- Try
list_available_datato see what's accessible - Some data requires connected wearables (Whoop, Oura, etc.)
Related Integrations
Ready to Start?
Generate your API token from Developer Settings and connect your health data to Cursor in under 5 minutes.