English Français العربية

FreeStyle Libre (LibreLinkUp)

Official registry Other

Read-only FreeStyle Libre CGM glucose readings, graphs and logbook via LibreLinkUp

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package freestyle-libre-mcp
Claude Code 
claude mcp add freestyle-libre-librelinkup -e 'LIBRELINKUP_EMAIL=<LIBRELINKUP_EMAIL>' -e 'LIBRELINKUP_PASSWORD=<your librelinkup_password>' -e 'LIBRELINKUP_REGION=US' -- uvx freestyle-libre-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "freestyle-libre-librelinkup": {
            "command": "uvx",
            "args": [
                "freestyle-libre-mcp==0.1.1"
            ],
            "env": {
                "LIBRELINKUP_EMAIL": "<LIBRELINKUP_EMAIL>",
                "LIBRELINKUP_PASSWORD": "<your librelinkup_password>",
                "LIBRELINKUP_REGION": "US"
            }
        }
    }
}

Environment variables

  • LIBRELINKUP_EMAIL required LibreLinkUp follower account email
  • LIBRELINKUP_PASSWORD required secret LibreLinkUp follower account password
  • LIBRELINKUP_REGION LibreLinkUp region of the account
OCI package ghcr.io/osjayaprakash/freestyle-libre-mcp:0.1.1
Claude Code 
claude mcp add freestyle-libre-librelinkup -e 'LIBRELINKUP_EMAIL=<LIBRELINKUP_EMAIL>' -e 'LIBRELINKUP_PASSWORD=<your librelinkup_password>' -e 'LIBRELINKUP_REGION=US' -- docker run -i --rm ghcr.io/osjayaprakash/freestyle-libre-mcp:0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "freestyle-libre-librelinkup": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/osjayaprakash/freestyle-libre-mcp:0.1.1"
            ],
            "env": {
                "LIBRELINKUP_EMAIL": "<LIBRELINKUP_EMAIL>",
                "LIBRELINKUP_PASSWORD": "<your librelinkup_password>",
                "LIBRELINKUP_REGION": "US"
            }
        }
    }
}

Environment variables

  • LIBRELINKUP_EMAIL required LibreLinkUp follower account email
  • LIBRELINKUP_PASSWORD required secret LibreLinkUp follower account password
  • LIBRELINKUP_REGION LibreLinkUp region of the account

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. freestyle-libre-mcp
  2. Tools
  3. Setup
  4. Langfuse tracing (optional)
  5. Development
  6. License

freestyle-libre-mcp

An MCP server that gives Claude (or any MCP client) read-only access to FreeStyle Libre CGM glucose readings shared through LibreLinkUp. It talks to the LibreLinkUp API with its own small async client (librelinkup_mcp.core); the API behaviour it relies on follows pylibrelinkup.

Tools

ToolReturns
list_patientsPeople the LibreLinkUp account follows
get_current_glucoseLatest reading with trend arrow
get_glucose_graphReadings from about the last 12 hours, oldest first
get_glucose_logbookLogged events from about the last 2 weeks, oldest first

Every reading tool takes an optional patient: a name ("Ann Lee", "ann") or a patient_id from list_patients. It can be omitted when the account follows one person.

Readings include value in the account's unit, value_mg_dl, unit, timestamp (the sensor's local time), timestamp_utc, and is_high/is_low flags. The current reading also has age_minutes, since LibreLinkUp returns the last known value when the sensor or phone is out of range.

Setup

For a step-by-step guide, including account setup and troubleshooting, see the installation guide. Full documentation is at https://freestyle-libre-mcp.readthedocs.io.

You need a LibreLinkUp follower account: invite it from the LibreLink app, accept the invite in the LibreLinkUp app, and accept any terms there before using this server.

git clone https://github.com/osjayaprakash/freestyle-libre-mcp.git && cd freestyle-libre-mcp
uv sync
VariableRequiredDefaultMeaning
LIBRELINKUP_EMAILyesFollower account email
LIBRELINKUP_PASSWORDyesFollower account password
LIBRELINKUP_REGIONnoUSOne of US, EU, EU2, AE, AP, AU, CA, DE, FR, JP, LA, RU

If the region is wrong, the first tool call tells you which one to set.

Run from PyPI

No clone needed; uv fetches and runs the published package:

uvx freestyle-libre-mcp

In a client config, use "command": "uvx", "args": ["freestyle-libre-mcp"].

Run with Docker

The server speaks MCP over stdio, so keep -i:

docker run -i --rm \
  -e LIBRELINKUP_EMAIL -e LIBRELINKUP_PASSWORD -e LIBRELINKUP_REGION \
  ghcr.io/osjayaprakash/freestyle-libre-mcp:latest

In a client config, use "command": "docker" with those arguments, and pass the variables through the client's env block.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "librelinkup": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/freestyle-libre-mcp", "run", "freestyle-libre-mcp"],
      "env": {
        "LIBRELINKUP_EMAIL": "you@example.com",
        "LIBRELINKUP_PASSWORD": "your-password",
        "LIBRELINKUP_REGION": "US"
      }
    }
  }
}
Claude Code
claude mcp add librelinkup \
  -e LIBRELINKUP_EMAIL=you@example.com \
  -e LIBRELINKUP_PASSWORD=your-password \
  -e LIBRELINKUP_REGION=US \
  -- uv --directory /absolute/path/to/freestyle-libre-mcp run freestyle-libre-mcp

Langfuse tracing (optional)

Each tool call becomes a Langfuse trace, with a child span for the LibreLinkUp API call. Install the extra and set the keys:

uv sync --extra langfuse

In the server command, use run --extra langfuse freestyle-libre-mcp instead of run freestyle-libre-mcp.

VariableMeaning
LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEYTracing is on only when both are set
LANGFUSE_BASE_URLLangfuse URL for self-hosted or regional instances (default: Langfuse Cloud)
LANGFUSE_CAPTURE_DATAtrue to include tool inputs, outputs and error messages. Default false

Privacy: glucose readings and patient names are health data. By default, traces hold only tool names, timings, patient UUIDs, and error class names. Setting LANGFUSE_CAPTURE_DATA=true sends readings and names to your Langfuse instance; only do that with an instance you trust, such as a self-hosted one.

Development

uv sync
uv run pytest            # offline suite
uv run pytest -m live    # hits the real API; needs LIBRELINKUP_EMAIL/PASSWORD
uv run ruff check src tests && uv run ruff format --check src tests

License

MIT

Frequently asked questions

What is FreeStyle Libre (LibreLinkUp)?

Read-only FreeStyle Libre CGM glucose readings, graphs and logbook via LibreLinkUp

How do I install FreeStyle Libre (LibreLinkUp)?

It runs on your machine. In Claude Code: claude mcp add freestyle-libre-librelinkup -e 'LIBRELINKUP_EMAIL=<LIBRELINKUP_EMAIL>' -e 'LIBRELINKUP_PASSWORD=<your librelinkup_password>' -e 'LIBRELINKUP_REGION=US' -- uvx freestyle-libre-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does FreeStyle Libre (LibreLinkUp) need an API key?

Yes. It expects LIBRELINKUP_EMAIL, LIBRELINKUP_PASSWORD, which you set in its configuration.

Is FreeStyle Libre (LibreLinkUp) open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains FreeStyle Libre (LibreLinkUp)?

It is published by osjayaprakash. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.