Grades are a hygiene check, not a security guarantee.

Codex, Plugin

Telegram Plugin

Local-first Telegram MCP server and Codex plugin with a safe read/search/draft default mode for AI agents

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

PERMISSION_DELETE_FILES NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ

Why this grade

  • PERMISSION_DELETE_FILES Low

    Contains a call that can delete files.

    control-plane/scripts/bench_doctor.py, line 43 completed = subprocess.run(

  • NETWORK_NO_FIXED_HOST Low

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

    control-plane/scripts/smoke-approve-flow.py, line 80 with urllib.request.urlopen(approve_url, timeout=10) as resp:

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    control-plane/src/telegram_control_plane/managed_systems.py, line 70 return mcp_repo / ".env"

  • SECRETS_ENV_READ Note

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

    mcp/src/telegram_mcp/fast_read_today.py, line 183 token = os.environ.get("TELEGRAM_MCP_AUTH_TOKEN", "").strip()

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

    control-plane/scripts/bench_doctor.py, line 43

    completed = subprocess.run(

    control-plane/src/telegram_control_plane/audit_remediation.py, line 424

    completed = subprocess.run(

    control-plane/src/telegram_control_plane/audits.py, line 466

    completed = subprocess.run(

    Show more

    control-plane/src/telegram_control_plane/audits.py, line 863

    completed = subprocess.run(

    control-plane/src/telegram_control_plane/golden_read_smoke.py, line 85

    completed = subprocess.run(

    control-plane/src/telegram_control_plane/kit_install.py, line 43

    subprocess.run(

    control-plane/src/telegram_control_plane/mcp_surface_probe.py, line 72

    completed = subprocess.run(

    control-plane/src/telegram_control_plane/music_autoclean.py, line 368

    raw = subprocess.check_output(

    mcp/src/telegram_mcp/client_media.py, line 457

    os.remove(out_path)

  • Install and update

    Pass

    No install-time script found, and dependencies are pinned or absent.

  • Network

    Concern

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

    NETWORK_NO_FIXED_HOST

    control-plane/scripts/smoke-approve-flow.py, line 80

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

    control-plane/src/telegram_control_plane/audits.py, line 141

    with urllib.request.urlopen(url, timeout=timeout) as response:

    control-plane/src/telegram_control_plane/music_autoclean.py, line 422

    with urllib.request.urlopen(request, timeout=20) as response:

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    control-plane/src/telegram_control_plane/managed_systems.py, line 70

    return mcp_repo / ".env"

    experiments/tdlib-media-poc/benchmark/login_tdlib.py, line 60

    load_dotenv(POC_ROOT / ".env")

    mcp/src/telegram_mcp/fast_read_today.py, line 183

    token = os.environ.get("TELEGRAM_MCP_AUTH_TOKEN", "").strip()

    Show more

    experiments/tdlib-media-poc/benchmark/run_tdlib.py, line 103

    load_dotenv(POC_ROOT / ".env")

    mcp/scripts/install-launchd.sh, line 16

    ENV_FILE="${TELEGRAM_MCP_ENV_FILE:-${PROJECT_ROOT}/.env}"

    mcp/scripts/install-launchd.sh, line 100

    : "${TELEGRAM_API_ID:?'TELEGRAM_API_ID must be set in .env or environment'}"

    mcp/scripts/install-launchd.sh, line 101

    : "${TELEGRAM_API_HASH:?'TELEGRAM_API_HASH must be set in .env or environment'}"

    mcp/scripts/launchd-run.sh, line 6

    ENV_FILE="${TELEGRAM_MCP_ENV_FILE:-${PROJECT_ROOT}/.env}"

    mcp/src/telegram_mcp/config.py, line 20

    env_file=".env",

    mcp/src/telegram_mcp/mcp_http_client.py, line 180

    token = os.environ.get("TELEGRAM_MCP_AUTH_TOKEN", "").strip()

    mcp/src/telegram_mcp/mcp_http_client.py, line 222

    token = os.environ.get("TELEGRAM_MCP_AUTH_TOKEN", "").strip()

    mcp/src/telegram_mcp/mcp_prewarm.py, line 54

    token = os.environ.get("TELEGRAM_MCP_AUTH_TOKEN", "").strip()

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

Get the full report on this tool, £49

Note

Hygiene check of commit b0305df4128d. can delete files. 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: b0305df4128d0522d9c64266d88b1927764f46e0

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