gree-ac-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GREE_MCP_CONFIG | No | Path to the config file (alternative to --config flag) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_devicesA | List all configured GREE air conditioners with their connectivity status and last-known state. |
| get_device_statusA | Return the full decoded status of one device (power, mode, temperatures, fan, swing, xFan, light, quiet/turbo, etc). |
| get_room_temperatureA | Return the calibrated current temperature in °C. If the unit lacks a real sensor and fakeSensor is enabled, the value is derived from the target temperature and flagged with "estimated": true. |
| set_powerC | Turn a device on or off. |
| set_modeB | Set the operating mode. Also powers the unit on. |
| set_target_temperatureA | Set the target temperature in °C. Rejected (not silently clamped) if outside the device's configured min/max range. |
| set_fan_speedB | Set the fan speed. "quiet" and "turbo" engage the dedicated modes. On 3-speed units the intermediate steps are mapped down gracefully. |
| set_oscillationA | Enable or disable louver swing. Applies the per-device configured oscillation positions (no raw swing codes required). |
| set_xfanA | Enable/disable X-Fan (keeps the fan running after shutdown to dry the coil). Only usable if xFan is enabled in config. |
| set_lightA | Turn the front-panel display light on/off. Only usable if lightControl is enabled in config. |
| set_quiet_modeA | Enable/disable quiet mode. Turning it on disables turbo mode. |
| set_turbo_modeB | Enable/disable turbo (powerful) mode. Turning it on disables quiet mode. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Each tool targets a distinct control or status query: list/get for reading, set for writing, and within set_* each corresponds to a different AC function (power, mode, temperature, fan, oscillation, xfan, light, quiet, turbo). The only potential overlap is that set_mode also powers the unit on, but the description explicitly notes this, making it clear rather than ambiguous.
All tools follow a consistent verb_noun snake_case pattern: list_devices, get_device_status, and set_power etc. The verbs are limited to list/get/set, and the nouns match the domain entities. The only slight exception is set_xfan (rather than set_x_fan), but this is minor and doesn't break the pattern.
Twelve tools is well within the ideal 3–15 range and each tool addresses a distinct aspect of controlling a GREE AC. The set is neither inflated with redundant operations nor so small that it feels thin.
The tool surface covers the full lifecycle of controlling a device: discovering it, reading full status and current temperature, and setting all major operating parameters (power, mode, target temperature, fan speed, oscillation, xfan, light, quiet, turbo). No critical control is missing, and the config-dependent tools are clearly documented.