Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Ha Mcp

A Model Context Protocol (MCP) server that provides AI assistants with access to Home Assistant, enabling smart home control and automation management.

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.

NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP

Why this grade

  • NETWORK_NO_FIXED_HOST Low

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

    AGENTS.md, line 70 → WebSocket (most operations) OR REST API (automation/script/scene CRUD)

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    AGENTS.md, line 30 set -a && source .env.integration && set +a && task test:integration

  • SECRETS_ENV_READ Note

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

    internal/handlers/integration/suite_test.go, line 47 token := os.Getenv("HA_INTEGRATION_TEST_TOKEN")

  • OBFUSCATION_FILE_OVER_READ_CAP Note

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

    internal/handlers/helpers_consolidated_test.go, line 1 // Package handlers provides MCP tool handlers for Home Assistant operations.

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

    Pass

    No shell or command execution found, and no extra permission was declared.

  • 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

    AGENTS.md, line 70

    → WebSocket (most operations) OR REST API (automation/script/scene CRUD)

    internal/handlers/helpers_consolidated.go, line 1203

    // fetch (unlike a single-entity GetState poll), so the interval is floored

    internal/handlers/labels_validation_test.go, line 342

    t.Errorf("expected exactly 1 registry fetch (no retry possible), got %d", calls)

    Show more

    internal/homeassistant/cached_client.go, line 280

    // underlying WS call is already a targeted single-entity fetch (unlike GetEntityRegistry, which

    internal/homeassistant/entity_poller.go, line 75

    // FULL entity-registry fetch (unlike WaitForEntityAppear's single-entity

    internal/homeassistant/hybrid_client.go, line 218

    // that are not supported via WebSocket (e.g., deleting automations/scripts/scenes).

    internal/homeassistant/hybrid_client_test.go, line 67

    // Create HybridClient with nil WebSocket (we're only testing REST)

    .claude/skills/ha-mcp/ha-mcp-gotchas/SKILL.md, line 39

    | `get` still shows pre-change config right after a successful `update`/`patch` | Reads are WebSocket (`automation/config`/`script/config`), writes are REST - a config write only b

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    AGENTS.md, line 30

    set -a && source .env.integration && set +a && task test:integration

    AGENTS.md, line 399

    set -a && source .env.integration && set +a && go test -tags=integration -v ./internal/handlers/integration/...

    internal/handlers/integration/suite_test.go, line 47

    token := os.Getenv("HA_INTEGRATION_TEST_TOKEN")

    Show more

    cmd/ha-mcp/main.go, line 78

    // config, preserving the documented priority: CLI flags > ENV > .env > YAML.

    cmd/ha-mcp/main.go, line 124

    - .env: Environment variables file

    cmd/ha-mcp/main.go, line 145

    // Create .env

    cmd/ha-mcp/main.go, line 146

    wasCreated, err = a.writeConfigFile(cmd, ".env", configs.EnvExample)

    cmd/ha-mcp/main.go, line 161

    cmd.Println(" 1. Edit config.yaml or .env with your Home Assistant settings")

    cmd/ha-mcp/main_test.go, line 267

    expectedFiles := []string{"config.yaml", ".env"}

  • 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

    internal/handlers/helpers_consolidated_test.go, line 1

    // Package handlers provides MCP tool handlers for Home Assistant operations.

  • 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 45501ed90aa4. 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: 45501ed90aa41c3215844938c88ddbdf2bfd5eb2

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