Grades are a hygiene check, not a security guarantee.

MCP, MCP server

screentime

screentime, an MCP server listed in the PlugVet directory.

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 c25696a3ddac, unchanged since the check below.

PERMISSION_DELETE_FILES NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV INSTALL_DOCUMENTED_INSTALLER OBFUSCATION_FILE_OVER_READ_CAP

Why this grade

  • PERMISSION_DELETE_FILES Low

    Contains a call that can delete files.

    src/screentime/config.py, line 92 result = subprocess.run(

  • NETWORK_NO_FIXED_HOST Low

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

    src/screentime/health.py, line 56 response = requests.post(

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    .gitignore, line 38 docker/.env

  • INSTALL_DOCUMENTED_INSTALLER Note

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

    README.md, line 88 - [uv](https://docs.astral.sh/uv/) (`curl -LsSf https://astral.sh/uv/install.sh | sh`). It brings its own Python 3.11+.

  • OBFUSCATION_FILE_OVER_READ_CAP Note

    A file was over the read cap and was not fully read.

    uv.lock, line 1 version = 1

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/screentime/config.py, line 92

    result = subprocess.run(

    src/screentime/launchd.py, line 84

    return subprocess.run(

    src/screentime/taxonomy.py, line 167

    paths = subprocess.run(

    Show more

    src/screentime/wizard.py, line 122

    subprocess.run(["open", FDA_PANE], check=False)

    src/screentime/wizard.py, line 314

    shutil.rmtree(launchd.log_dir())

    src/screentime/sources/knowledgec.py, line 57

    return subprocess.run(

  • Install and update

    Note

    README documents an installer that pipes a download into a shell. The docs document an installer that pipes a download into a shell.

    INSTALL_DOCUMENTED_INSTALLER

    README.md, line 88

    - [uv](https://docs.astral.sh/uv/) (`curl -LsSf https://astral.sh/uv/install.sh | sh`). It brings its own Python 3.11+.

    docs/setup.md, line 8

    - [uv](https://docs.astral.sh/uv/) (`curl -LsSf https://astral.sh/uv/install.sh | sh`).

  • Network

    Concern

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

    NETWORK_NO_FIXED_HOST

    src/screentime/health.py, line 56

    response = requests.post(

    src/screentime/health.py, line 77

    response = requests.get(

    src/screentime/homeassistant.py, line 208

    response = requests.post(

    Show more

    src/screentime/influx.py, line 216

    response = requests.post(

    src/screentime/taxonomy.py, line 134

    response = requests.get(

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_PATH_DOTENV

    .gitignore, line 1

    # Credentials

    .gitignore, line 38

    docker/.env

    CHANGELOG.md, line 67

    - Configuration moved from `.env` to `config.toml` (mode `0600`). `INFLUX_*`,

    Show more

    CHANGELOG.md, line 88

    - `run.py`, `.env.example` and the hand-edited `examples/launchd.plist`.

    README.md, line 106

    cp docker/.env.example docker/.env # set INFLUX_TOKEN and both passwords

    README.md, line 107

    docker compose -f docker/docker-compose.yml --env-file docker/.env up -d

    README.md, line 131

    v2 replaces the CSV, `.env` and `aw-import-screentime` with one installed tool. The v1 Home Assistant entity ids stay. Steps: [docs/migration.md](docs/migration.md).

    docker/docker-compose.yml, line 2

    # cp docker/.env.example docker/.env # set a real token and passwords

  • Agent instructions

    Pass

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

  • Obfuscation

    Note

    a file was over the read cap and was not fully read.

    OBFUSCATION_FILE_OVER_READ_CAP

    uv.lock, line 1

    version = 1

  • 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 c25696a3ddac. can delete files. README documents an installer that pipes a download into a shell. The docs document 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. a file was over the read cap and was not fully read.

Date and source

Date checked:

View source

github.com

Commit graded: c25696a3ddac32058ae809f63c04e2bfc0c8dc0f

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