How to Use the Composio Smart Home MCP in Windsurf

Q: How do I configure the Composio Smart Home MCP Server in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers block. Alternatively, use the Windsurf Settings UI under Cascade to add the server URL. Cascade automatically reads the available tools once you hit refresh.

Run your entire physical house autonomously by letting Windsurf chain complex smart device commands.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Composio Smart Home MCP to Windsurf

Create your Vinkius account to connect Composio Smart Home to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Composio Smart Home with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain multi-device actions with Windsurf Cascade

Cascade uses `execute_multiple_composio_tools` to run a sequence of commands across different smart brands in one go without stopping to ask for confirmation. It handles the whole plan behind the scenes. To do this, it runs `list_connected_accounts` first to see what platforms are connected. Once it has that list, it builds a logical sequence to dim the bulbs, lower the blinds, and turn on the receiver.

Natural language control for complex setups

You don't need to look up exact JSON schemas for your thermostat when Cascade can execute commands using `execute_composio_tool_with_text` directly from your workspace. Just tell the agent to cool the room down. If Cascade needs to inspect the exact parameters a device accepts, it calls `get_composio_tool_schema` behind the scenes. This allows the agent to translate your casual requests into exact API payloads.

Auto-discover your smart home integrations

This MCP Server exposes your entire smart home setup so Windsurf can browse it on demand using `list_composio_tools`. The agent maps those tools to your local code files or automation scripts. When you need to find a specific device integration, Cascade uses `search_composio_tools` to filter through your connected hardware. You get instant access to your physical devices inside your development environment.

Setup guide

Set up Composio Smart Home MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Composio Smart Home MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Composio Smart Home payment history." If connected, Cascade will call the Composio Smart Home tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "composio-smart-home-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Composio. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Composio Smart Home now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Composio Smart Home MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` block. Alternatively, use the Windsurf Settings UI under Cascade to add the server URL. Cascade automatically reads the available tools once you hit refresh.

Yes, Cascade handles multi-step plans autonomously. It uses the `execute_multiple_composio_tools` endpoint to bundle actions like turning off kitchen lights and locking doors into a single execution thread.

Yes, Cascade can pass conversational instructions directly to your devices. It uses the `execute_composio_tool_with_text` tool to parse your plain English requests and map them to physical hardware actions.

You can ask Cascade to list them, or look up specific integrations directly. It uses `list_app_tools` to fetch the capabilities of any specific smart home platform connected to your account.

All device authentication tokens and smart lock credentials are isolated inside the Vinkius sandboxed environment. Your raw passwords never touch the Windsurf interface or LLM context windows, as Vinkius manages the secure API handshake on its own infrastructure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript