Gevety

Connect Gevety to Claude Desktop

Query your health data with natural language using the Model Context Protocol (MCP).

Easy~5 minutesMCP Protocol

Prerequisites

Gevety Account - Need one? Create a free account
Claude Desktop - Download from claude.ai/download
Python 3.10+ or uv package manager installed

Get Your API Token

First, you'll need to generate an API token from your Gevety account. This token allows Claude to access your health data securely.

Log in to your Gevety account at gevety.com
Go to Profile → Developer tab
Click "Create New Token"
Give your token a name (e.g., "Claude Desktop")
Copy the token - you won't be able to see it again!

Tip: Your token only accesses your own data. You can revoke it anytime from the Developer tab.

Install the Gevety MCP Package

Install the Gevety MCP server package. You can use either pip or uvx:

Option A: Using pip

pip install gevety-mcp

Option B: Using uvx (recommended)

uvx gevety-mcp

Using uvx is recommended as it runs the package directly without requiring a separate install step.

Configure Claude Desktop

Add the Gevety MCP server to your Claude Desktop configuration file:

macOS:~/Library/Application Support/Claude/claude_desktop_config.json

Windows:%APPDATA%\Claude\claude_desktop_config.json

Add the following configuration (or merge with existing):

claude_desktop_config.json

{
  "mcpServers": {
    "gevety": {
      "command": "uvx",
      "args": ["gevety-mcp"],
      "env": {
        "GEVETY_API_TOKEN": "your-token-here"
      }
    }
  }
}

Important: Replace your-token-here with your actual API token from Step 1.

Restart Claude Desktop

Completely quit and reopen Claude Desktop for the changes to take effect. On macOS, use Cmd+Q to fully quit.

You should now see a small hammer icon (🔨) in the bottom right of the chat input, indicating MCP tools are available.

Start Asking Questions!

You're all set! Try asking Claude questions like:

"What were my cholesterol levels in my last test?"

"How has my vitamin D changed over time?"

"What's my biological age?"

"What does my health protocol recommend?"

"What supplements am I taking and are they helping?"

"When is my next recommended blood test?"

Available MCP Tools

The Gevety MCP server provides 11 tools for querying your health data:

get_health_summaryOverall health score and axis breakdown

query_biomarkerQuery specific biomarker values and history

get_biological_ageYour calculated biological age

get_protocolYour personalized health protocol

list_supplementsCurrent supplements and assessments

get_opportunitiesTop health improvement opportunities

get_wearable_statsGarmin, Oura, Whoop data

get_activitiesRecent workouts and activities

get_today_actionsToday's action items

get_upcoming_testsRecommended tests schedule

list_available_dataOverview of all available data

Troubleshooting

Claude doesn't show the hammer icon

Make sure Claude Desktop is fully quit and reopened
Check that your config file is valid JSON (no trailing commas)
Verify the config file is in the correct location
Make sure Python 3.10+ or uv is installed and in your PATH

"Authentication failed" error

Verify your API token is correct (no extra spaces or quotes)
Check that the token hasn't been revoked in your Gevety account
Try generating a new token from Profile → Developer

"No data found" responses

Make sure you've uploaded at least one lab report
Verify you're asking about biomarkers that exist in your data
Try list_available_data to see what's available

Related Integrations

Need Help?

Having trouble setting up? Check out our support page or email us.