# Composio Smart Home MCP

> Composio Smart Home MCP connects your AI client to over 1000 smart device integrations, including Philips Hue and Sensibo. It lets you control everything—from dimming lights and setting temperatures to managing security systems—using simple natural language or precise JSON arguments.

## Overview
- **Category:** friends-mcp
- **Price:** Free
- **Tags:** smart-home, api-integration, natural-language-processing, unified-api, automation-framework

## Description

This MCP gives your agent a unified brain for every connected smart home device. Instead of jumping between five different manufacturer apps just to adjust the mood, you talk to your AI client, and it handles everything. Composio abstracts away all the complicated API keys and authentication mess. Whether you want to run a complex routine—like 'turn on the movie lights and set the AC to 20 degrees'—or just check the current temperature reading, this MCP manages the connections. You don't need individual setup for every brand; one key opens up access to hundreds of ecosystems. It’s all managed through Vinkius, giving your agent a central hub that can execute actions across climate control, entertainment, and lighting systems.

## Tools

### execute_composio_tool
Runs a smart home tool using structured JSON arguments for precise control over parameters.

### execute_multiple_composio_tools
Sends one request that runs several different smart home tools sequentially, either with text or JSON arguments.

### search_composio_tools
Searches through the entire catalog of tools using keywords or app names.

### execute_composio_tool_with_text
Executes a smart home tool simply by passing a natural language instruction to the AI client.

### get_composio_tool_schema
Retrieves the full technical schema for a specific tool so you know exactly what inputs it expects.

### list_app_tools
Shows all available tools and actions specifically for one smart home brand or app integration.

### list_connected_accounts
Lists all the physical or virtual accounts (like your Hue bridge) that are connected to this MCP.

### list_composio_tools
Provides a catalog of every single tool and smart home system integrated into the Composio platform.

## Prompt Examples

**Prompt:** 
```
List all available smart home tools I can execute.
```

**Response:** 
```
I found 150+ smart home tools available through Composio. Key categories include: Sensibo (climate control — turn on/off AC, set temperature), Philips Hue (lighting — turn on/off, dim, change color), SmartThings (hub — control devices, scenes), and many more. Use `search_composio_tools` to find tools for specific apps.
```

**Prompt:** 
```
Turn on my living room AC and set it to 22°C.
```

**Response:** 
```
Executing tool SENSIBO_TURN_ON with text instruction "turn on living room AC and set to 22°C"... Done! Your living room AC is now on and set to 22°C. The Sensibo device has been configured successfully.
```

**Prompt:** 
```
Show me all tools available for Sensibo.
```

**Response:** 
```
Found 8 Sensibo tools: SENSIBO_TURN_ON, SENSIBO_TURN_OFF, SENSIBO_SET_AC (set temperature/mode), SENSIBO_GET_AC_STATE, SENSIBO_SET_TIMER, SENSIBO_SET_SCHEDULE, SENSIBO_GET_ROOMS, SENSIBO_GET_MEASUREMENTS. You can execute any of these using `execute_composio_tool` or `execute_composio_tool_with_text`.
```

## Capabilities

### Execute single device commands
Run specific smart home actions using structured JSON arguments for maximum precision.

### Control devices with conversation
Issue complex routines or changes just by telling your AI client what you want to do in plain English.

### Build multi-step workflows
Sequence several actions across different types of devices (e.g., dimming lights, then locking doors) in one single request.

### Discover system capabilities
Search and view the full technical schema for any smart home tool or integration available.

### View connected accounts
List which specific smart home brands and accounts are currently linked to your Composio setup.

## Use Cases

### The Property Manager needs a nightly check.
Instead of manually logging into the HVAC and lighting apps for 20 units, the agent runs an automated sequence. It first uses `list_connected_accounts` to confirm all buildings are online, then executes multiple tools to ensure every unit's lights are off and temperature is set back.

### The user wants movie-night ambiance.
A simple prompt tells the agent: 'Start Movie Night.' The MCP intercepts this request, automatically executing a sequence that dims Philips Hue lights, lowers the smart blinds, and sets the living room AC to 21°C.

### The developer needs to validate inputs.
Before writing code, a developer calls `get_composio_tool_schema` for a specific device. This immediately provides the full JSON schema, confirming exactly what data types and parameters are required before execution.

### The agent must handle sequential tasks.
A complex 'Good Morning' routine requires multiple steps: first checking the weather (a tool), then adjusting the thermostat (another tool). The agent uses `execute_multiple_composio_tools` to guarantee the entire sequence runs correctly.

## Benefits

- Unified Control: You don't need dozens of API keys. This MCP gives your agent access to 1000+ devices via a single connection, simplifying complex automation.
- Two Ways to Talk: Need precision? Use JSON arguments with `execute_composio_tool`. Just talking? Use natural language through `execute_composio_tool_with_text`.
- Complex Routines are Easy: The `execute_multiple_composio_tools` function lets you build multi-step workflows (e.g., dim lights, set temperature, and lock doors) in one single call.
- Know What You're Doing: If you aren't sure what parameters a tool needs, use `get_composio_tool_schema` to pull the full technical documentation first.
- Always Find It: Use `list_composio_tools` or `search_composio_tools` to browse every single capability across all connected smart home brands.

## How It Works

The bottom line is that you tell your agent what you want done—the MCP figures out which APIs to hit and how to talk to them.

1. First, subscribe to this MCP and enter your unique Composio API key.
2. Next, instruct your AI client to use the smart home tools. You can provide a simple text prompt or structured JSON data.
3. The system interprets your command, handles all the authentication complexity, and executes the action across the connected devices.

## Frequently Asked Questions

**What smart home devices and apps are supported through Composio?**
Composio provides access to 1000+ smart home tool integrations including Sensibo (climate control), Philips Hue (lighting), SmartThings (hub), and many more device ecosystems. Use `list_composio_tools` to discover all available tools, or `search_composio_tools` to find tools for specific apps or categories.

**What's the difference between executing a tool with arguments vs. with text?**
**With arguments** (`execute_composio_tool`): You provide a JSON object matching the tool's exact schema. This gives you precise control over every parameter. **With text** (`execute_composio_tool_with_text`): You provide natural language instructions like "turn on the AC to 72 degrees" and Composio's AI parses and maps it to the correct parameters. Use arguments for precision, text for convenience.

**How do I get a Composio API key?**
Visit https://app.composio.dev/ and sign up for a Composio account. Navigate to your API settings or developer dashboard to generate an API key (starts with `ak_`). The key gives you access to all available smart home tool integrations.

**Do I need separate authentication for each smart home app?**
No! Composio handles authentication to individual smart home services internally. You only need your Composio API key. However, you may need to connect your accounts to specific services through Composio's connection management first. Use the `connected_account_id` parameter when executing tools if you have multiple accounts connected.

**How do I use `get_composio_tool_schema` to validate a specific smart home tool?**
It returns the complete JSON schema and all accepted parameters for any Composio tool. This lets your agent pre-validate inputs before making a live API call, which prevents execution errors.

**What is the best way to run complex routines using `execute_multiple_composio_tools`?**
This tool runs multiple Composio actions in one sequence. You provide several tools and their arguments or text instructions in a single request, guaranteeing multi-step automation.

**How do I use `list_composio_tools` to discover available capabilities?**
It provides an inventory of all smart home tools and integrations Composio supports. Your agent can use this function to quickly map out what's possible across the full catalog.

**How do I check which services are connected using `list_connected_accounts`?**
This function lists all smart home accounts and integrations linked to your API key. It helps confirm exactly which device ecosystems your AI client can control right now.