LibreLink

This MCP server lets you access FreeStyle Libre glycemic data through Claude Desktop. It is updated to support API v4.16.0+ and includes secure credential storage, automatic token refresh, region handling, and automatic Account-Id header management to align with the latest API requirements.

How to use

You run this MCP server locally and connect Claude Desktop to it as an extension. The server exposes a set of tools to read current glucose, history, and statistics, and to configure credentials and regions. Start the server, configure your LibreLinkUp credentials and region, then integrate the server into Claude Desktop so you can ask natural language questions about your glucose data and receive structured results.

How to install

Prerequisites you need before installing the MCP server:

• Node.js version 18.0.0 or newer

• A LibreLinkUp account with data sharing enabled

• A active FreeStyle Libre 2 or 3 sensor

• Claude Desktop for MCP integration

Install the server by following the recommended bundle path. The bundle includes the precompiled MCP server and is the simplest setup.

Step 1. Install key storage library for secure credentials (recommended)

npm install keytar

Note: If keytar cannot be installed, the system will fall back to a encrypted file-based storage automatically.

Step 2. Download the precompiled bundle

wget https://github.com/sedoglia/librelink-mcp-server/releases/download/v1.3.0/librelink-mcp-server.mcpb

Step 3. Verify integrity (optional but recommended)

wget https://github.com/sedoglia/librelink-mcp-server/releases/download/v1.3.0/librelink-mcp-server.mcpb.sha256
sha256sum -c librelink-mcp-server.mcpb.sha256

Step 4. Install the extension in Claude Desktop (recommended)

Open Claude Desktop → Settings → Extensions → Advanced settings → Extension Developer → Install Extension… → select librelink-mcp-server.mcpb

Step 5. Configure LibreLink credentials securely (recommended)

In Claude Desktop, start a new chat and send:
Configura le credenziali di accesso per LibreLink

Then provide:

• Utente: your LibreLink email
• Password: your LibreLinkUp password

These credentials will be encrypted and stored in the system’s native vault (Keychain, Credential Manager, or Secret Service).

Step 6. Restart Claude Desktop to apply the integration

Close Claude Desktop completely
Reopen Claude Desktop
Check Settings → Developer to confirm the connection status is verified

Additional sections

Configuration and security details are important for safe operation. The server stores credentials securely using AES-256-GCM encryption. The preferred storage method is the OS keychain (Keytar). If Keytar is unavailable, a secure local file-based key is used as a fallback. Tokens are persisted securely to avoid repeated logins.

Supported regions are configured during credential setup and include 13 LibreLinkUp regions. The system automatically handles regional redirects and token refresh to keep the connection healthy.

Troubleshooting common issues includes verifying that you are using the latest API version (4.16.0+), ensuring the Account-Id header is sent, and confirming that Claude Desktop is correctly configured to load the MCP server.

Tools exposed by the MCP server include glucose data queries and credential configuration. You can request current glucose, glucose history, statistics, trends, sensor info, and session management actions.

If you need to test the connection or validate credentials, use the provided test workflow after configuring credentials and region.

Available tools

get_current_glucose

Fetches the current glucose value with trend information for the active session.

get_glucose_history

Retrieves historical glucose data (default 24 hours, configurable).

get_glucose_stats

Returns statistics such as mean glucose, GMI, and time-in-range.

get_glucose_trends

Analyzes patterns and trends in glucose data, such as dawn phenomenon and stability.

get_sensor_info

Provides information about the active sensor.

configure_credentials

Configures and encrypts LibreLinkUp credentials for secure storage.

configure_ranges

Sets personalized target glucose ranges.

validate_connection

Tests the MCP connection to ensure data can be retrieved.

get_session_status

Checks the current authentication session status.

clear_session

Clears the authentication session to force re-login.