{"repo":"paulomac1000/ha-mcp-readonly","free":true,"listed":false,"github":"https://github.com/paulomac1000/ha-mcp-readonly","clone":"git clone https://github.com/paulomac1000/ha-mcp-readonly.git","description":"Homeassistant MCP server with readonly functions","language":"Python","stars":42,"topics":[],"license":"MIT","category":"mcp-servers","readme_excerpt":"HA-MCP-Readonly Read-only MCP (Model Context Protocol) server for Home Assistant. Gives AI assistants (Claude Desktop, LibreChat, Cline) full observability into your smart home — entity states, automations, scripts, devices, logs, diagnostics — without any write access. Also generates static AI context snapshots for RAG systems, ChatGPT Projects, Qwen, and other tools that accept custom knowledge files. Built in Python, runs anywhere — locally, in Docker, or as an MCP integration. Requirements - Python 3.11+ (for local use) or Docker - A Home Assistant instance with a long-lived access token - Create one in your HA profile: Settings → Security → Long-Lived Access Tokens - Access to your Home Assistant config directory (for filesystem tools) Quick Start 1. Configure environment Edit .env with your credentials: IMPORTANT: The .env file contains your access token. It is gitignored and must never be committed. 2. Run with Docker First, configure your credentials. Either use a .env file (recommended) or pass variables directly. Option A — with .env file and docker compose: The included docker-compose.yml pulls the image from GitHub Container Registry and mounts your HA config read-only: Option B — with plain docker run : Building locally: 3. Run locally (Python 3.11+) Ports Port Protocol Purpose Endpoint ------ ---------- --------- ---------- 9091 HTTP Health check GET /health 9092 HTTP Authenticated Streamable HTTP MCP /mcp 9093 HTTP Optional authenticated REST API + Context Gene","default_branch":null,"files":null,"tree":[],"storefront":"/r/paulomac1000","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/paulomac1000/ha-mcp-readonly/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}