MCP Setup Guide

Connect vytalLink to any MCP-compatible client in minutes

Claude Desktop
Cursor
VS Code
Any MCP Client

Prerequisites

What you need before setting up MCP integration

vytalLink Mobile App

Download and set up the vytalLink mobile app to generate connection codes.

App Store Google Play

Node.js & npm

Required to install and run the vytalLink MCP server package.

Download Node.js

MCP Client

Any MCP-compatible client like Claude Desktop, Cursor, or VS Code with MCP support.

Claude Desktop

Setup Instructions

Choose your MCP client and follow the setup guide

1

Install the MCP Server

Looking for the one-click experience? Use the Claude Desktop bundle guide instead.

Install the vytalLink MCP server package globally using npm:

Terminal 
npm install -g @xmartlabs/vytallink-mcp-server
2

Configure Claude Desktop

Add vytalLink to your Claude Desktop configuration file:

Configuration file location:

~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
~/.config/claude/claude_desktop_config.json
claude_desktop_config.json 
{
  "mcpServers": {
    "vytalLink": {
      "command": "npx",
      "args": [
        "@xmartlabs/vytallink-mcp-server"
      ]
    }
  }
}
3

Restart Claude Desktop

Close and restart Claude Desktop to load the new MCP server configuration.

4

Connect Your Health Data

Use the connection codes from your vytalLink mobile app to authenticate:

You: Connect to my health data using code HEALTH7 and password sunset42
Claude: I've successfully connected to your health data! I can now help you analyze your fitness metrics, sleep patterns, and wellness trends.
1

Install the MCP Server

Install the vytalLink MCP server package:

Terminal 
npm install -g @xmartlabs/vytallink-mcp-server
2

Configure Cursor

Add vytalLink to your Cursor MCP configuration:

Cursor MCP Configuration 
{
  "mcpServers": {
    "vytalLink": {
      "command": "npx",
      "args": [
        "@xmartlabs/vytallink-mcp-server"
      ]
    }
  }
}
3

Enable MCP in Cursor

Make sure MCP is enabled in Cursor settings and restart the application.

Check Cursor's documentation for the latest MCP setup instructions
1

Install MCP Extension

Install an MCP-compatible extension in VS Code (availability may vary).

MCP support in VS Code is evolving. Check the VS Code marketplace for MCP extensions.
2

Install the MCP Server

Terminal 
npm install -g @xmartlabs/vytallink-mcp-server
3

Configure MCP Server

Create or edit the MCP configuration file in your VS Code user directory:

~/Library/Application Support/Code/User/mcp.json
%APPDATA%\Code\User\mcp.json
~/.config/Code/User/mcp.json
mcp.json 
{
  "servers": {
    "vytalLink": {
      "command": "npx",
      "args": ["@xmartlabs/vytallink-mcp-server"]
    }
  }
}
4

Restart VS Code

Close and restart VS Code to load the new MCP server configuration.

1

Install the MCP Server

Terminal 
npm install -g @xmartlabs/vytallink-mcp-server
2

Generic MCP Configuration

Use this configuration template for any MCP-compatible client:

MCP Configuration Template 
{
  "mcpServers": {
    "vytalLink": {
      "command": "npx",
      "args": [
        "@xmartlabs/vytallink-mcp-server"
      ]
    }
  }
}
3

Client-Specific Setup

Follow your MCP client's documentation to:

  • Add the server configuration
  • Enable MCP functionality
  • Restart the application

Troubleshooting

Common issues and solutions

MCP server not found

Verify that @xmartlabs/vytallink-mcp-server is installed globally and npx is available in your PATH.

Authentication failed

Check that you're using the correct connection codes from your vytalLink mobile app. Codes expire after some time.

No health data

Ensure your mobile app has permission to access health data and is actively syncing with your device's health platform.

Need More Help?

If you're still having issues, check our documentation or reach out for support:

GitHub Repository Contact Support