.env.example

# Home Assistant MCP Server Configuration
# Copy this file to .env and fill in your Home Assistant details

# Home Assistant instance URL (include http:// or https://)
HOMEASSISTANT_URL=https://your-homeassistant.local:8123

# Home Assistant long-lived access token
# Get this from: Home Assistant -> Profile -> Long-Lived Access Tokens
HOMEASSISTANT_TOKEN=your_long_lived_access_token_here

# Server Configuration
HA_TIMEOUT=30
HA_MAX_RETRIES=3

# Tool Configuration
FUZZY_THRESHOLD=60
ENTITY_SEARCH_LIMIT=20

# WebSocket Configuration (essential for async operations)
ENABLE_WEBSOCKET=true

# Development/Debug Configuration
DEBUG=false
LOG_LEVEL=INFO

# Tool Search: replace the full tool catalog (~92 tools) with search-based
# discovery (~4 proxy tools). Reduces idle context from ~46K to ~5K tokens.
# Recommended for models without deferred tool support or with limited context.
# ENABLE_TOOL_SEARCH=false

# Managed YAML config editing: allows ha_config_set_yaml to add/replace/remove
# top-level keys in configuration.yaml and packages/*.yaml.
# ENABLE_YAML_CONFIG_EDITING=false

# Tool visibility seed values (comma-separated tool names). On first start
# these are written to tool_config.json; after that the web settings UI at
# http://<server>/settings is the source of truth. See DOCS.md for details.
# DISABLED_TOOLS=
# PINNED_TOOLS=

# Max results from ha_search_tools (2-10, default 5).
# TOOL_SEARCH_MAX_RESULTS=5

# Optional: MCP Server Configuration
MCP_SERVER_NAME=ha-mcp
# MCP_SERVER_VERSION defaults to the package version (e.g. 6.7.2)