Help and Support » MCP Server

This guide explains how to connect Antigravity to the Runalyze MCP Server so Antigravity can access your Runalyze data through the Model Context Protocol (MCP).

Prerequisites

Before you begin:

1. Install and configure Antigravity.
2. Have an active Runalyze Premium Membership.

Step 1: Create a Runalyze API Token

1. Open https://runalyze.com/settings/personal-api
2. Create a new Personal API Token.
3. Copy the generated Bearer Token.

Note: The MCP server requires a valid Runalyze Premium account and a Personal API Token.

Step 2: Configure Antigravity

Open your Antigravity MCP configuration and add the Runalyze MCP server:

{
  "mcpServers": {
    "runalyze": {
      "serverUrl": "https://runalyze.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_RUNALYZE_TOKEN"
      },
      "trust": true
    }
  }
}

Replace YOUR_RUNALYZE_TOKEN with the Bearer Token you generated in Runalyze. (It's the Personal Token, but starting with pt#

Important: Antigravity uses serverUrl. Do not use httpUrl here.

Alternative: Use an Environment Variable

Instead of storing the token directly in the configuration file, you can use an environment variable.

macOS / Linux

export RUNALYZE_API_TOKEN="your_bearer_token_here"

Windows PowerShell

$env:RUNALYZE_API_TOKEN="your_bearer_token_here"

Then configure Antigravity like this:

{
  "mcpServers": {
    "runalyze": {
      "serverUrl": "https://runalyze.com/mcp",
      "headers": {
        "Authorization": "Bearer ${RUNALYZE_API_TOKEN}"
      },
      "trust": true
    }
  }
}

Step 3: Restart Antigravity

Restart Antigravity after saving the configuration.

Step 4: Verify the Connection

Check Antigravity’s MCP server list. You should see a connected MCP server named:

runalyze

Example Prompts

Once connected, you can ask Antigravity questions such as:

Show my last 10 running activities.

What was my average resting heart rate this month?

Summarize my training load for the last 4 weeks.

How has my HRV changed over the last 30 days?

Troubleshooting

Server not visible

• Verify your Premium subscription is active.
• Confirm the Bearer Token is valid.
• Restart Antigravity after editing the configuration.
• Make sure the configuration uses serverUrl, not httpUrl.

Authentication errors

Verify that the Authorization header is configured exactly as follows:

Authorization: Bearer <token>

Connection errors

Ensure that the MCP endpoint is reachable:

https://runalyze.com/mcp

Also make sure your configuration contains valid JSON.