The Google Health Developer Model Context Protocol (MCP) server gives
AI-powered development tools and agents the ability to search and retrieve
up-to-date, grounded documentation for the Google Health API---with no API key or
authentication setup required.

An MCP server acts as a proxy between an external service that provides context
or data and an AI application (the host). The Google Health Developer MCP
server exposes executable tools that let Large Language Models (LLMs) find
precise answers directly from indexed documentation. To learn more about MCP
servers, see
[What is the MCP and how does it work?](https://cloud.google.com/discover/what-is-model-context-protocol#what-is-the-mcp-and-how-does-it-work).

The server operates over the standard MCP Streamable HTTP transport at:

```console
https://healthdevelopers.googleapis.com/mcp
```

## Available tools

The server provides two core tools for technical documentation discovery and
retrieval:

- [`search_health_docs`](https://developers.google.com/health/reference/mcp/tools_list/search_health_docs.md.txt): Searches Google Health API documentation for relevant technical content chunks matching your query. Each chunk includes the page title, source URL, relevant text content, and canonical document resource name.
- [`get_health_docs`](https://developers.google.com/health/reference/mcp/tools_list/get_health_docs.md.txt): Retrieves the complete Markdown content of one or more documentation pages using the resource names returned by `search_health_docs`.

For full input and output schemas, see the
[Google Health Developer MCP reference](https://developers.google.com/health/reference/mcp.md.txt). All content is
scoped strictly to public technical documentation hosted under
`https://developers.google.com/health/`.

## Prerequisites

To connect to the server, you need an MCP-compatible AI development environment
or code assistant, such as:

- [Gemini CLI](https://geminicli.com/docs/tools/mcp-server/)
- Google Antigravity ([Antigravity CLI](https://antigravity.google/docs/cli-getting-started), [Antigravity 2.0](https://antigravity.google/docs/getting-started), or [Antigravity IDE](https://antigravity.google/docs/ide-getting-started))
- [OpenAI Codex](https://developers.openai.com/codex/mcp)
- [Claude Code](https://code.claude.com/docs/en/overview)
- [Cursor](https://cursor.com/docs/cli/overview)
- [Grok CLI](https://docs.x.ai/build/features/mcp-servers)
- [GitHub Copilot in VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)

## Configure your client

Connect immediately using a one-click IDE installer, a single CLI command, an
editor configuration file, or an automated chat prompt. No Google Cloud project
or API key is required.

### One-click IDE installation

If you use Google Antigravity, Cursor, or Visual Studio Code, select one of the
following buttons to open your editor and install the `HealthDevelopers` MCP
server:

[Add to Antigravity](antigravity://plugin/google-health-developer)
[Add to Cursor](https://cursor.com/en/install-mcp?name=HealthDevelopers&config=eyJ1cmwiOiJodHRwczovL2hlYWx0aGRldmVsb3BlcnMuZ29vZ2xlYXBpcy5jb20vbWNwIn0%3D)
[Add to VS Code](https://vscode.dev/redirect/mcp/install?name=HealthDevelopers&config=%7B%22type%22:%22http%22,%22url%22:%22https://healthdevelopers.googleapis.com/mcp%22%7D)

### Command-line and editor setup

Select your AI client from the following tabs to add the server with a single
command or configuration entry:

### Gemini CLI

Add the server to
[Gemini CLI](https://geminicli.com/docs/tools/mcp-server/)
using the `gemini mcp add` command:

```bash
gemini mcp add --transport http --scope user \
  HealthDevelopers https://healthdevelopers.googleapis.com/mcp
```

### Google Antigravity

Add the server using the
[Antigravity CLI](https://antigravity.google/docs/mcp):

```bash
agy mcp add HealthDevelopers https://healthdevelopers.googleapis.com/mcp
```

Alternatively, open `~/.gemini/config/mcp_config.json` (or
`.agents/mcp_config.json` in your workspace) and add `HealthDevelopers` under
`mcpServers`. **Antigravity CLI** , **Antigravity 2.0** , and **Antigravity
IDE** all share `~/.gemini/config/mcp_config.json`:

```json
{
  "mcpServers": {
    "HealthDevelopers": {
      "serverUrl": "https://healthdevelopers.googleapis.com/mcp"
    }
  }
}
```

### Codex

Add the server to
[OpenAI Codex](https://developers.openai.com/codex/mcp)
using the `codex mcp add` command:

```bash
codex mcp add HealthDevelopers \
  --url https://healthdevelopers.googleapis.com/mcp
```

### Claude Code

Add the server to
[Claude Code](https://code.claude.com/docs/en/overview)
using the `claude mcp add` command:

```bash
claude mcp add HealthDevelopers \
  --transport http https://healthdevelopers.googleapis.com/mcp
```

### Cursor

If you prefer manual configuration instead of the one-click button, add the
server to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json`
(project-level):

```json
{
  "mcpServers": {
    "HealthDevelopers": {
      "url": "https://healthdevelopers.googleapis.com/mcp"
    }
  }
}
```

### Grok

Add the server to
[Grok CLI](https://docs.x.ai/build/features/mcp-servers)
using the `grok mcp add` command:

```bash
grok mcp add --transport http \
  HealthDevelopers https://healthdevelopers.googleapis.com/mcp
```

### GitHub Copilot

If you prefer manual configuration instead of the one-click button, edit
`.vscode/mcp.json` in your workspace (or add the configuration under an
`"mcp"` root key in your
[VS Code user settings](https://code.visualstudio.com/docs/getstarted/personalize-vscode)):

```json
{
  "servers": {
    "HealthDevelopers": {
      "type": "http",
      "url": "https://healthdevelopers.googleapis.com/mcp"
    }
  }
}
```

### Automated setup using a prompt

If your AI assistant supports managing MCP tool configurations directly from
chat, instruct your assistant to configure the server by pasting the following
prompt:

```
Please configure the Google Health Developer MCP server for me:
- Name: HealthDevelopers
- Server URL: https://healthdevelopers.googleapis.com/mcp
- Transport: http
```

## Verify your connection

Confirm that `HealthDevelopers` is connected in Gemini CLI or Google
Antigravity:

### Gemini CLI

Run `gemini mcp list` from your terminal (or enter `/mcp` inside an
interactive session):

```bash
gemini mcp list
```

Confirm that `HealthDevelopers` reports `Connected`:

    Configured MCP servers:

    ✓ HealthDevelopers: https://healthdevelopers.googleapis.com/mcp (http) - Connected

### Google Antigravity

- **Antigravity CLI** : Enter `/mcp` in the prompt panel to open the MCP
  Manager and confirm `HealthDevelopers` shows an active status ring, or
  run `agy mcp list` from your terminal:

      NAME              TYPE  STATUS   COMMAND/URL
      HealthDevelopers  http  enabled  https://healthdevelopers.googleapis.com/mcp

- **Antigravity IDE** : Click **...** at the top of the agent side panel,
  select **MCP Servers** \> **Manage MCP Servers** , and confirm
  `HealthDevelopers` is enabled.

- **Antigravity 2.0** : Open **Settings** \> **Customizations** \> **Installed
  MCP Servers** and confirm `HealthDevelopers` is listed.

## Example prompts

Once connected, your assistant automatically calls `search_health_docs` and
`get_health_docs` when you ask about the Google Health API:

```
What OAuth scopes are needed to read steps and heart rate data in the Google
Health API, and how do I query daily step rollups?
```

```
Migrate my Fitbit Web API /1/user/-/activities/steps endpoint call to the
Google Health API v4.
```

```
How do I set up webhook subscriptions in the Google Health API to receive
updates when new sleep or workout data arrives?
```

## Test with curl

You can also test the endpoint directly using `curl`. The MCP Streamable HTTP
transport requires both `Content-Type: application/json` and
`Accept: application/json, text/event-stream` headers.

### List available tools

Run the following command to list the tools exposed by the server:

```bash
curl -s -X POST "https://healthdevelopers.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
```

### Search documentation

Run the following command to test `search_health_docs`:

```bash
curl -s -X POST "https://healthdevelopers.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "search_health_docs",
      "arguments": {
        "query": "steps scope",
        "pageSize": 2
      }
    }
  }'
```

### Retrieve full document Markdown

Run the following command to test `get_health_docs`:

```bash
curl -s -X POST "https://healthdevelopers.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "get_health_docs",
      "arguments": {
        "names": [
          "documents/developers.google.com/health/data-types/steps"
        ]
      }
    }
  }'
```

## Feedback and support

To report issues, suggest improvements, or get help with the Google Health
Developer MCP server, use the feedback and support channels on the
[Google Health API support page](https://developers.google.com/health/support).