Grades are a hygiene check, not a security guarantee.

MCP, MCP server

io.github.AshwanthramKL/whoop-mcp

A local Model Context Protocol (MCP) server that gives an LLM read-only access to your WHOOP fitness data.

Compatibility: Not stated.

Grade B

Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

Rescanned at commit a34d3eb5bc37, unchanged since the check below.

PERMISSION_DELETE_FILES INSTALL_UNPINNED NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV INSTALL_DOCUMENTED_INSTALLER SECRETS_ENV_READ

Why this grade

  • PERMISSION_DELETE_FILES Low

    Contains a call that can delete files.

    src/auth_manager.py, line 260 os.remove(self.storage_path)

  • INSTALL_UNPINNED Low

    Dependencies use a range or git URL with no lockfile.

    README.md, line 92 `curl -LsSf https://astral.sh/uv/install.sh | sh` (or `brew install uv`).

  • NETWORK_NO_FIXED_HOST Low

    Makes a network call whose host is not written as a fixed address.

    src/auth_manager.py, line 186 response = requests.post(

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    .env.example, line 2 # Copy to .env (or export in your shell) and fill in. Never commit .env.

  • INSTALL_DOCUMENTED_INSTALLER Note

    Documentation shows an installer that pipes a download into a shell.

    README.md, line 92 `curl -LsSf https://astral.sh/uv/install.sh | sh` (or `brew install uv`).

  • SECRETS_ENV_READ Note

    Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.

    src/config.py, line 11 WHOOP_CLIENT_SECRET = os.getenv("WHOOP_CLIENT_SECRET", "")

Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.

Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.

What was checked

Plain notes from the hygiene checks.

  • Permissions

    Concern

    can delete files.

    PERMISSION_DELETE_FILES

    src/auth_manager.py, line 260

    os.remove(self.storage_path)

    src/whoop_install_skills.py, line 99

    shutil.rmtree(dest)

  • Install and update

    Concern

    dependencies are not pinned. README documents an installer that pipes a download into a shell.

    INSTALL_UNPINNED INSTALL_DOCUMENTED_INSTALLER

    README.md, line 92

    `curl -LsSf https://astral.sh/uv/install.sh | sh` (or `brew install uv`).

    requirements.txt, line 1

    mcp>=1.0.0

  • Network

    Concern

    can reach a host that is not written as a fixed address.

    NETWORK_NO_FIXED_HOST

    src/auth_manager.py, line 186

    response = requests.post(

    src/setup_direct_oauth.py, line 92

    resp = requests.post(

    src/whoop_install_skills.py, line 63

    with urllib.request.urlopen(req, timeout=10) as resp:

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    src/config.py, line 11

    WHOOP_CLIENT_SECRET = os.getenv("WHOOP_CLIENT_SECRET", "")

    .env.example, line 2

    # Copy to .env (or export in your shell) and fill in. Never commit .env.

    .gitignore, line 97

    # Environments

    Show more

    CHANGELOG.md, line 61

    - `.env.example` rewritten. Previous file referenced `OAUTH_BASE_URL` pointing at the long-removed third-party OAuth proxy and didn't mention `WHOOP_CLIENT_ID` / `WHOOP_CLIENT_SECR

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Pass

    No encoded or minified payload found.

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit a34d3eb5bc37. can delete files. dependencies are not pinned. README documents an installer that pipes a download into a shell. can reach a host that is not written as a fixed address. reads a credential or environment file.

Date and source

Date checked:

View source

github.com

Commit graded: a34d3eb5bc37fdc32127caf17e4483ddd217f434

This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.

Read how this letter is chosen