# Quick Start Guide
## Use This MCP Server to Rename All Your Flows!
This MCP server will enable Claude to automatically rename all 57 flows according to your new naming convention.
## Setup (5 minutes)
### 1. Install Dependencies
```bash
cd "/Users/andy/projects/ndygen/home automation/mcp-server-homey"
npm install
```
### 2. Get Homey Credentials
**Option A: Create New App (Recommended)**
1. Go to https://tools.developer.homey.app/
2. Click "Create App"
3. Name: "MCP Server"
4. Redirect URL: `http://localhost:8080`
5. Copy your **Client ID** and **Client Secret**
**Option B: Use Existing App**
If you already have a Homey app, use those credentials.
### 3. Configure
```bash
cp .env.example .env
```
Edit `.env`:
```env
HOMEY_CLIENT_ID=your_client_id_from_step_2
HOMEY_CLIENT_SECRET=your_client_secret_from_step_2
HOMEY_ID=643ea3ec935ed70b81742e5e
```
(Your Homey ID is already filled in from the URL we saw earlier)
### 4. Build
```bash
npm run build
```
### 5. Add to Claude Desktop
Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"homey": {
"command": "node",
"args": [
"/Users/andy/projects/ndygen/home automation/mcp-server-homey/build/index.js"
]
}
}
}
```
### 6. Restart Claude Desktop
Close and reopen Claude Desktop completely.
## Usage - Rename All Flows
Once Claude Desktop restarts with the MCP server, you can say:
> "Using the Homey MCP server, please rename all my flows according to the migration guide in FLOW_NAMING_MIGRATION.md. Start with the binnen/ flows (44 flows, lowercase only), then do globaal/ flows (add glo: prefix), and finally buitenruimtes/ flows (add bui: prefix)."
Claude will:
1. ✅ List all current flows
2. ✅ Read the migration mapping
3. ✅ Rename each flow one by one
4. ✅ Report progress and any errors
5. ✅ Verify all flows were updated correctly
## Alternative: Manual Commands
### List all flows
> "List all my Homey flows"
### Rename a single flow
> "Rename the flow with ID '271b8359-7835-434c-bd65-05c3b88da8bf' to 'wz_comfort_blokkeren'"
### Batch rename with pattern
> "Find all flows starting with 'WK:' and rename them to lowercase (wk:)"
## Verify After Renaming
> "List all flows and check they match the new naming convention in flow-naming-conventions.md"
## Troubleshooting
### "Tool not found: list_flows"
- Claude Desktop needs to be restarted after adding MCP server
- Check that `claude_desktop_config.json` has correct path
- Check that `npm run build` completed successfully
### "Authentication failed"
- Verify `.env` file has correct credentials
- Check Homey ID is correct (from URL)
- Try recreating the app in Homey Developer Tools
### "Flow not found"
- Flow IDs must be exact
- Use `list_flows` to get current IDs
- Check flow wasn't deleted
## Time Estimate
With the MCP server:
- **Setup:** 5 minutes
- **Rename 57 flows:** ~2-3 minutes (automated!)
- **Verification:** 2 minutes
- **Total:** ~10 minutes
vs. Manual via Homey UI: ~45-60 minutes
## Success!
After all flows are renamed, you'll have:
- ✅ 44 binnen/ flows in lowercase
- ✅ 7 globaal/ flows with `glo:` prefix
- ✅ 3 buitenruimtes/ flows with `bui:` prefix
- ✅ Consistent naming across your entire Homey system
- ✅ Future flows easy to name correctly
🎉 Your Homey flows are now professionally organized!
