Connect to Your AI Assistant

Prerequisites

• BeastHeart app installed with at least one HRV reading
• Cloud sync enabled in the app (Settings → Cloud Sync)

Claude

Connect BeastHeart to Claude for native MCP support. The connector is configured on claude.ai and syncs automatically to Claude Desktop and the Claude mobile app. You only need to set it up once.

Requires: Claude Pro, Max, Team, or Enterprise plan (connectors are not available on the free plan).

Step 1 — Add the Connector

1. Go to claude.ai → Settings → Connectors
2. Click Add custom connector
3. Enter the MCP server URL:

   https://mcp.beastheart.app/oauth

4. Click Connect

Step 2 — Authorize BeastHeart

You’ll be redirected to sign in to your BeastHeart account and authorize Claude to access your HRV data.

Step 3 — Start Chatting

That’s it! The connector syncs to Claude Desktop and the mobile app automatically. Just ask Claude about your recovery:

ChatGPT

Connect BeastHeart to ChatGPT as a native MCP connector. Once connected, just ask natural questions about your recovery.

Requires: ChatGPT Pro, Plus, Business, Enterprise, or Edu subscription with Developer Mode enabled.

Step 1 — Enable Developer Mode

1. Go to Settings → Apps → Advanced settings
2. Toggle Developer mode on

Step 2 — Create the BeastHeart App

1. Go to Settings → Apps → Create app
2. Fill in the details:
   • Name: BeastHeart
   • Description: Access your HRV and readiness data for recovery insights
   • Authentication: OAuth
   • OAuth Client ID: leave blank
   • OAuth Client Secret: leave blank
3. Check “I understand and want to continue”

Step 3 — Enter the MCP Endpoint

Enter the MCP endpoint URL:

https://mcp.beastheart.app/chatgpt

Step 4 — Authorize

1. Click Create
2. Sign in to your BeastHeart account when prompted
3. Authorize ChatGPT to access your HRV data

That’s it! Start chatting with your recovery data.

Claude Code

If you set up the claude.ai connector above, it syncs to Claude Code automatically. Alternatively, add BeastHeart to your ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "beastheart": {
      "type": "url",
      "url": "https://mcp.beastheart.app/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Replace <your-api-key> with the API key from your app (Settings → Cloud Sync → API Key).

Other MCP Assistants

Any MCP-compatible client can connect to BeastHeart. Point it at https://mcp.beastheart.app/mcp with your API key as a Bearer token. The server supports the streamable-http transport.

Available Tools

Once connected, your AI assistant can call these tools:

Troubleshooting