UBOS Asset Marketplace: @genm/switchbot-mcp - Your Gateway to AI-Powered Smart Home Automation
In the rapidly evolving landscape of AI and IoT, the ability to seamlessly integrate smart home devices with AI assistants is becoming increasingly crucial. At UBOS, we understand this need and are proud to feature the @genm/switchbot-mcp within our Asset Marketplace. This Model Context Protocol (MCP) server acts as a vital bridge, allowing your AI agents to interact with and control your SwitchBot devices, thereby unlocking a new level of automation and convenience.
What is @genm/switchbot-mcp?
The @genm/switchbot-mcp is an MCP server specifically designed to provide SwitchBot device control capabilities to AI assistants. Built with the Model Context Protocol, it standardizes how applications provide context to Large Language Models (LLMs). This means that AI models can access and interact with your SwitchBot devices in a structured and predictable manner, paving the way for sophisticated smart home automation scenarios.
Think of it as a translator, ensuring that your AI assistant can understand and execute commands related to your SwitchBot devices. This integration opens up possibilities beyond simple on/off controls, enabling complex interactions and personalized experiences.
Key Features
The @genm/switchbot-mcp boasts a rich set of features, making it a powerful tool for anyone looking to integrate their SwitchBot devices with AI:
- Device Discovery: Easily list all connected SwitchBot devices.
- Status Monitoring: Retrieve real-time status updates for each device.
- Remote Control: Control devices remotely, including turning them on/off.
- Settings Management: Modify device settings as needed.
- Scene Execution: Trigger predefined scenes for coordinated actions across multiple devices.
- Sensor Data: Access sensor information such as temperature, humidity, brightness, and motion (where available).
Use Cases: Unleashing the Power of AI-Driven Automation
The true potential of @genm/switchbot-mcp lies in its diverse range of use cases. Here are some examples of how you can leverage this integration to enhance your smart home experience:
Voice-Controlled Home Automation: Imagine telling your AI assistant, “Hey, turn on the living room floor lamp” or “Close the bedroom curtains.” With
@genm/switchbot-mcp, this becomes a reality. Seamlessly control your devices with simple voice commands.Adaptive Environmental Control: Use sensor data to automatically adjust device settings. For example, the AI can monitor the temperature and turn on the AC when it gets too hot, or activate a humidifier when the humidity drops.
Scheduled Scene Execution: Create scenes that automate complex tasks. Schedule the “Good Morning” scene to open the curtains, turn on the coffee maker, and adjust the lighting to your preferred settings, all before you even get out of bed.
Personalized Comfort: Allow the AI to learn your preferences and proactively adjust device settings to optimize your comfort. For instance, it might dim the lights and lower the AC when you start watching a movie.
Enhanced Security: Integrate motion sensors to trigger alerts or actions. The AI can notify you if motion is detected in your home while you’re away, or automatically turn on the lights to deter intruders.
Energy Efficiency: Optimize energy consumption by automatically turning off devices when they’re not in use. The AI can detect when a room is empty and switch off the lights and appliances to save energy.
Elderly or Disability Support: The MCP server can provide support for elderly or disabled individuals by automating tasks that would otherwise be difficult or impossible to perform independently.
Installation and Setup
Integrating @genm/switchbot-mcp into your smart home setup is straightforward. You can choose between two installation methods:
1. Smithery Installation (Recommended)
Smithery offers a seamless installation experience for Claude Desktop. Simply run the following command in your terminal:
bash npx -y @smithery/cli install @genm/switchbot-mcp --client claude
2. Manual Installation
If you prefer a manual approach, follow these steps:
Install the package using npm:
bash npm install @genm/switchbot-mcp
Configure the SwitchBot API. This involves obtaining a token and secret key from the SwitchBot app.
Add the MCP server configuration to your
claude_desktop_config.jsonfile, specifying the command, arguments, and environment variables.Set the
SWITCHBOT_TOKENandSWITCHBOT_SECRETenvironment variables with your API credentials.
Detailed instructions and code snippets are provided in the original documentation for your convenience.
Device Compatibility
The @genm/switchbot-mcp supports a wide range of SwitchBot devices, including:
- Plugs
- Bots
- Curtains
- Air Conditioners
- Humidifiers
- Lights
- Remote Controls
To ensure optimal performance, it’s recommended to use descriptive names for your devices, such as “Bedroom Curtain” instead of just “Curtain”. This helps AI assistants understand the context and location of each device, enabling more natural and intuitive interactions.
Troubleshooting
If you encounter any issues during setup or operation, refer to the troubleshooting section in the documentation. Common problems include device unresponsiveness and authentication errors. Solutions include verifying Bluetooth range, checking battery status, regenerating API keys, and updating environment variables.
The UBOS Advantage: Integrating @genm/switchbot-mcp with Our AI Agent Platform
While the @genm/switchbot-mcp offers powerful integration capabilities on its own, it truly shines when combined with the UBOS platform. UBOS is a full-stack AI Agent Development Platform designed to bring AI agents to every business department.
Here’s how UBOS enhances the @genm/switchbot-mcp experience:
- Orchestration: UBOS allows you to orchestrate complex interactions between AI agents and your SwitchBot devices, creating sophisticated automation workflows.
- Data Integration: Connect your SwitchBot data with other enterprise data sources, providing your AI agents with a holistic view of your business and home environment.
- Custom AI Agent Development: Build custom AI agents tailored to your specific needs, leveraging your own LLM models and data.
- Multi-Agent Systems: Create multi-agent systems that coordinate multiple AI agents to achieve complex goals, such as optimizing energy consumption or enhancing home security.
In essence, UBOS provides the infrastructure and tools you need to build truly intelligent and autonomous smart home systems, powered by the @genm/switchbot-mcp and your SwitchBot devices.
By adding the @genm/switchbot-mcp to your UBOS-powered environment, you unlock the ability to:
- Create Personalized Home Automation Experiences: Tailor your smart home to your unique preferences and lifestyle.
- Improve Energy Efficiency: Optimize energy consumption and reduce your carbon footprint.
- Enhance Home Security: Protect your home and loved ones with intelligent security systems.
- Increase Convenience and Productivity: Automate mundane tasks and free up your time for more important activities.
Conclusion
The @genm/switchbot-mcp is a game-changer for anyone looking to integrate their SwitchBot devices with AI assistants. Its rich feature set, ease of installation, and compatibility with a wide range of devices make it an essential tool for building truly intelligent and automated smart homes. And when combined with the UBOS platform, the possibilities are endless. Explore the power of AI-driven smart home automation with the @genm/switchbot-mcp and UBOS today!
SwitchBot Server
Project Details
- genm/switchbot-mcp
- ISC License
- Last Updated: 2/28/2025
Recomended MCP Servers
将微信读书划线同步到Notion
MCP server to provide Jira Tickets information to AI coding agents like Cursor
develop MCP
A Model Context Protocol (MCP) server that automates generating LinkedIn post drafts from YouTube videos. This server provides...
MCP server to download entire websites
headless-ida-mcp-server
A lightweight MCP Server for integrating Google Docs, Sheets, and Slides with custom applications. Enables seamless document management,...
MCP Memory Server with PostgreSQL and pgvector for long-term memory capabilities





