FreeStyle Libre (LibreLinkUp) MCP server

freestyle-libre-mcp

<!-- mcp-name: io.github.osjayaprakash/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

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

Readings include value in the account's unit, valuemgdl, unit, timestamp (the sensor's local time), timestamputc, and ishigh/islow flags. The current reading also has ageminutes, 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 .

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

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 claudedesktopconfig.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

Shortened. The full README is on GitHub.