How to connect Apilio to Claude

Connect Claude Web, Desktop and Cowork to Apilio MCP. List all boolean variables and their status, show me all your current logicblocks, and more using natural language, with authentication handled for you.

Apilio logoApilio
Api KeyBasic

Apilio is a home automation platform that lets you connect and control smart devices from different brands. It helps you build flexible automations with complex conditions, schedules, and integrations.

8 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Apilio account to Claude via Composio Connect, enabling it to list all boolean variables and their status, show me all your current logicblocks, fetch numeric variables for your thermostat, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Apilio with

Connecting Apilio to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Apilio account

Back in Claude, ask it to connect to Apilio or give it any Apilio-related task.

For example, ask Claude to:

  • "List all boolean variables and their status"
  • "Show me all your current logicblocks"
  • "Fetch numeric variables for your thermostat"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Apilio account is ready to use.

What is the Apilio Claude Connector, and what's possible with it?

The Apilio MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Apilio account. It provides structured and secure access to your smart home variables, conditions, and automations, so your agent can perform actions like checking device states, evaluating logic, and managing automation variables on your behalf.

  • Monitor boolean device states: Instantly fetch and review all your boolean variables, so your agent can check if devices are on or off, active or inactive.
  • Track and evaluate automation conditions: Have your agent list and assess all available Apilio conditions, making it easy to troubleshoot or optimize home automation rules.
  • Access and analyze logicblocks: Let your agent retrieve your logicblocks to understand, manage, or trigger complex automations across your connected devices and services.
  • Review numeric variable values: Enable your agent to pull all numeric variables—like temperature, humidity, or energy usage—for smarter, context-aware automation decisions.
  • Manage string variables for messaging and triggers: Allow your agent to fetch and utilize string variables, supporting scenarios like status messages, custom notifications, or dynamic automation triggers.

Troubleshooting

1. Why does Claude not use the Composio connector for Apilio?

The connector can show as connected, but Claude must use it in each Apilio conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Apilio again.

2. Why does Claude show an MCP server error before Apilio connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Apilio.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Apilio.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Apilio authorization link not work?

The Composio connector is one server. Your Apilio account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Apilio connection.
  • Composio creates a fresh Apilio authorization link.
  • Open that link in your browser and finish the Apilio sign-in.

4. Why do Apilio actions fail after they worked before?

The Apilio connection can expire or lose permission.

  • Ask Claude to inspect the Apilio connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Apilio account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Apilio.
  • If the action still fails with a permission error, check that the connected account has that permission in Apilio itself.

5. How do I switch to a different Apilio account?

Claude can manage the Apilio connection for you.

  • Ask Claude to disconnect or delete the current Apilio account.
  • Ask Claude to connect Apilio again.
  • Open the new Composio authorization link for Apilio.
  • Sign in with the other Apilio account in the browser.
  • After the account connects, ask Claude to retry the Apilio task.

6. Why is my Apilio connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Apilio connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click and click Clear cache.
  • If Apilio tools still do not appear, click , disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Apilio.
TOOLS

Supported Tools

Every Apilio action and event your agent gets out of the box.

Get Boolean Variables

Tool to fetch all boolean variables.

Get Conditions

Retrieves all conditions from your Apilio account.

Get Logicblocks

Retrieves all logicblocks for the authenticated Apilio user.

Get Numeric Variables

Retrieves all numeric variables from your Apilio account with their current values and metadata.

Get String Variables

Tool to fetch all string variables.

List Time Conditions

Tool to fetch all time conditions of a user.

List Tuya Conditions

Tool to retrieve all Tuya conditions from your Apilio account.

List Variable Conditions

Tool to retrieve all variable conditions from your Apilio account.

FAQ

Frequently asked questions

With a standalone Apilio MCP server, the agents and LLMs can only access a fixed set of Apilio tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Apilio and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Apilio tools.

Yes, absolutely. You can configure which Apilio scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Apilio data and credentials are handled as safely as possible.

Start with Apilio.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Apilio tool your agent needs.Free to start.

Start building