Home Assistant MCP Server

{
  "functions": [
    {
      "name": "get_homeassistant_entities",
      "description": "Récupère la liste de toutes les entités Home Assistant disponibles avec possibilité de filtrage par domaine",
      "parameters": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string", 
            "description": "Filtrer par domaine spécifique (light, switch, sensor, climate, etc.)",
            "enum": ["light", "switch", "sensor", "climate", "binary_sensor", "camera", "cover", "fan", "lock", "media_player", "vacuum", "alarm_control_panel"]
          }
        }
      },
      "endpoint": {
        "method": "GET",
        "url": "http://192.168.1.22:3002/api/entities",
        "headers": {
          "Content-Type": "application/json"
        }
      }
    },
    {
      "name": "get_entity_state", 
      "description": "Récupère l'état détaillé d'une entité Home Assistant spécifique",
      "parameters": {
        "type": "object",
        "properties": {
          "entity_id": {
            "type": "string",
            "description": "L'ID complet de l'entité (ex: light.salon, switch.prise_1)",
            "required": true
          }
        },
        "required": ["entity_id"]
      },
      "endpoint": {
        "method": "GET", 
        "url": "http://192.168.1.22:3002/api/entities/{entity_id}",
        "headers": {
          "Content-Type": "application/json"
        }
      }
    },
    {
      "name": "control_light",
      "description": "Contrôle une lumière (allumer, éteindre, ajuster luminosité et couleur)",
      "parameters": {
        "type": "object",
        "properties": {
          "entity_id": {
            "type": "string",
            "description": "L'ID de la lumière (ex: light.salon)",
            "required": true
          },
          "action": {
            "type": "string",
            "description": "Action à effectuer",
            "enum": ["turn_on", "turn_off", "toggle"],
            "required": true
          },
          "brightness": {
            "type": "number",
            "description": "Luminosité de 0 à 255 (seulement pour turn_on)",
            "minimum": 0,
            "maximum": 255
          },
          "rgb_color": {
            "type": "array",
            "description": "Couleur RGB [rouge, vert, bleu] de 0 à 255",
            "items": {
              "type": "number",
              "minimum": 0,
              "maximum": 255
            },
            "minItems": 3,
            "maxItems": 3
          }
        },
        "required": ["entity_id", "action"]
      },
      "endpoint": {
        "method": "POST",
        "url": "http://192.168.1.22:3002/api/services/call",
        "headers": {
          "Content-Type": "application/json"
        },
        "body": {
          "domain": "light",
          "service": "{{action}}",
          "service_data": {
            "entity_id": "{{entity_id}}",
            "brightness": "{{brightness}}",
            "rgb_color": "{{rgb_color}}"
          }
        }
      }
    },
    {
      "name": "control_switch",
      "description": "Contrôle un interrupteur ou une prise (allumer, éteindre)",
      "parameters": {
        "type": "object", 
        "properties": {
          "entity_id": {
            "type": "string",
            "description": "L'ID de l'interrupteur (ex: switch.prise_salon)",
            "required": true
          },
          "action": {
            "type": "string",
            "description": "Action à effectuer",
            "enum": ["turn_on", "turn_off", "toggle"],
            "required": true
          }
        },
        "required": ["entity_id", "action"]
      },
      "endpoint": {
        "method": "POST",
        "url": "http://192.168.1.22:3002/api/services/call", 
        "headers": {
          "Content-Type": "application/json"
        },
        "body": {
          "domain": "switch",
          "service": "{{action}}",
          "service_data": {
            "entity_id": "{{entity_id}}"
          }
        }
      }
    },
    {
      "name": "control_climate",
      "description": "Contrôle le système de chauffage/climatisation",
      "parameters": {
        "type": "object",
        "properties": {
          "entity_id": {
            "type": "string", 
            "description": "L'ID du thermostat (ex: climate.salon)",
            "required": true
          },
          "temperature": {
            "type": "number",
            "description": "Température cible en degrés Celsius"
          },
          "hvac_mode": {
            "type": "string",
            "description": "Mode de fonctionnement",
            "enum": ["off", "heat", "cool", "auto", "dry", "fan_only"]
          }
        },
        "required": ["entity_id"]
      },
      "endpoint": {
        "method": "POST",
        "url": "http://192.168.1.22:3002/api/services/call",
        "headers": {
          "Content-Type": "application/json"
        },
        "body": {
          "domain": "climate", 
          "service": "set_temperature",
          "service_data": {
            "entity_id": "{{entity_id}}",
            "temperature": "{{temperature}}",
            "hvac_mode": "{{hvac_mode}}"
          }
        }
      }
    },
    {
      "name": "get_entity_history",
      "description": "Récupère l'historique d'une entité sur une période donnée",
      "parameters": {
        "type": "object",
        "properties": {
          "entity_id": {
            "type": "string",
            "description": "L'ID de l'entité",
            "required": true
          },
          "hours": {
            "type": "number",
            "description": "Nombre d'heures d'historique à récupérer",
            "default": 24,
            "minimum": 1,
            "maximum": 168
          }
        },
        "required": ["entity_id"]
      },
      "endpoint": {
        "method": "GET",
        "url": "http://192.168.1.22:3002/api/history?entity_id={{entity_id}}&hours={{hours}}",
        "headers": {
          "Content-Type": "application/json"
        }
      }
    },
    {
      "name": "call_custom_service",
      "description": "Appel d'un service Home Assistant personnalisé avec des paramètres flexibles",
      "parameters": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Le domaine du service (ex: automation, script, notify)",
            "required": true
          },
          "service": {
            "type": "string", 
            "description": "Le nom du service (ex: trigger, turn_on, send_message)",
            "required": true
          },
          "entity_id": {
            "type": "string",
            "description": "L'ID de l'entité cible (optionnel)"
          },
          "service_data": {
            "type": "object",
            "description": "Données supplémentaires pour le service",
            "additionalProperties": true
          }
        },
        "required": ["domain", "service"]
      },
      "endpoint": {
        "method": "POST",
        "url": "http://192.168.1.22:3002/api/services/call",
        "headers": {
          "Content-Type": "application/json"
        },
        "body": {
          "domain": "{{domain}}",
          "service": "{{service}}",
          "service_data": "{{service_data}}"
        }
      }
    },
    {
      "name": "check_server_health",
      "description": "Vérifie l'état de santé du serveur Home Assistant et la connectivité",
      "parameters": {
        "type": "object",
        "properties": {}
      },
      "endpoint": {
        "method": "GET",
        "url": "http://192.168.1.22:3002/health",
        "headers": {
          "Content-Type": "application/json"
        }
      }
    }
  ],
  "configuration": {
    "server_url": "http://192.168.1.22:3002",
    "description": "Serveur MCP Home Assistant pour contrôle domotique via IA",
    "version": "1.0.0",
    "documentation": "docs/LM_STUDIO_CONFIG.md"
  }
}