{
  "markdown": "# mcp-homeassistant\n\nMCP server exposing Home Assistant 2026.4.1 REST API functionality.\n\n[![PyPI](https://img.shields.io/pypi/v/mcp-homeassistant.svg)](https://pypi.org/project/mcp-homeassistant/)\n[![Python](https://img.shields.io/pypi/pyversions/mcp-homeassistant.svg)](https://pypi.org/project/mcp-homeassistant/)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n\nmcp-name: io.github.daedalus/mcp-homeassistant\n\n## Install\n\n```bash\npip install mcp-homeassistant\n```\n\n## Configuration\n\nSet the following environment variables:\n\n- `HA_URL`: Home Assistant URL (default: http://localhost:8123)\n- `HA_TOKEN`: Long-Lived Access Token (required)\n\n## Usage\n\n```bash\nexport HA_URL=\"http://homeassistant:8123\"\nexport HA_TOKEN=\"your_long_lived_access_token\"\nmcp-homeassistant\n```\n\n## Tools\n\nThe MCP server exposes the following tools:\n\n- `get_api_status` - Check if the API is running\n- `get_config` - Get HA configuration\n- `get_components` - List loaded components\n- `get_events` - List event types and listener counts\n- `get_services` - List available services by domain\n- `get_states` - Get all entity states\n- `get_state` - Get a specific entity state\n- `set_state` - Update or create an entity state\n- `delete_state` - Delete an entity state\n- `fire_event` - Fire a custom event\n- `call_service` - Call a Home Assistant service\n- `render_template` - Render a Jinja template\n- `get_history` - Get historical state changes\n- `get_logbook` - Get logbook entries\n- `check_config` - Validate configuration.yaml\n- `handle_intent` - Handle an intent\n- `get_error_log` - Get error log\n- `get_calendars` - List calendar entities\n- `get_calendar_events` - Get calendar events\n\n## Resources\n\n- `homeassistant://config` - Current config\n- `homeassistant://states` - All entity states\n- `homeassistant://services` - Available services\n- `homeassistant://components` - Loaded components\n\n## Development\n\n```bash\ngit clone https://github.com/daedalus/mcp-homeassistant.git\ncd mcp-homeassistant\npip install -e \".[test]\"\n\n# run tests\npytest\n\n# format\nruff format src/ tests/\n\n# lint\nruff check src/ tests/\n\n# type check\nmypy src/\n```\n",
  "bytes": 2224,
  "sha": "958db30d4199b2bbbf72567fe9877c2af40964fd097306d6db957c485f6a3819",
  "repo_slug": "daedalus/mcp-homeassistant",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_daedalus_mcp_homeassistant_500e4012/readme"
}