MCP HomeDoudou Server

MCP (Model Context Protocol) server for interacting with your HomeDoudou home automation system.

Description

This MCP server allows Claude (or other AI assistants) to interact directly with your HomeDoudou system to retrieve sensor data, manage your home automation devices, and get information about your connected hardware.

Features

🔧 Available Tools

• get_value - Quickly retrieves the value of a specific key by its alias
• get_my_keys - Retrieves all your HomeDoudou keys with associated hardware information
• get_keys_by_hardware - Retrieves keys from a specific hardware device
• get_key_details - Retrieves details of a specific key
• list_keys - Lists all available keys with their aliases (to help discover available keys)

📊 Supported Data Types

• Temperature
• Humidity
• Pressure
• Light
• And all other HomeDoudou sensor types

Installation

npm install mcp-homedoudou-server

Configuration

Required Environment Variables

export USER_API_KEY="your_homedoudou_api_key"
export METEOR_URL="https://www.homedoudou.fr"  # Optional, default value

Claude Desktop Configuration

Add this server to your Claude Desktop configuration (claude_desktop_config.json) :

{
  "mcpServers": {
    "homedoudou": {
      "command": "npx",
      "args": ["mcp-homedoudou-server"],
      "env": {
        "USER_API_KEY": "your_homedoudou_api_key"
      }
    }
  }
}

Usage

Once configured, you can use the tools directly in Claude:

Usage Examples

# List all your available keys
Use the "list_keys" tool to see all your keys with their aliases

# Get living room temperature
Use the "get_value" tool with alias "temperature_salon"

# View all your keys
Use the "get_my_keys" tool for a complete overview

# Get keys from a specific hardware
Use the "get_keys_by_hardware" tool with the hardware ID

Response Format

Responses are formatted in a readable way with:

• 📊 Current values
• 🏠 Hardware information
• ⏰ Last update dates
• 📈 Sensor types and styles

Development

Project Structure

mcp-homedoudou-server/
├── index.js          # Main MCP server
├── package.json      # NPM configuration
└── README.md         # Documentation

Available Scripts

npm start           # Start the server
npm version patch   # Increment version
npm publish         # Publish to npm

Security

• ✅ API token authentication
• ✅ HTTPS communication
• ✅ Parameter validation
• ✅ Robust error handling

Support

For any questions or issues:

• Verify that your USER_API_KEY is correct
• Ensure your HomeDoudou account is active
• Check logs for more details

License

MIT - See LICENSE file for more details.

Author

David FAIVRE-MAÇON

Developed for HomeDoudou - Your intelligent home automation system