The MCP server for your home
Connect Claude, or any agent that speaks MCP, and it can see and run every device in your Home app. It still asks before it unlocks, writes down everything it does, and never takes orders from a device’s name.
Built for agents
Homeswift is an MCP server, the standard way AI agents reach tools. Add it to Claude as a custom connector, sign in with your web UI account, and decide how far it may go. Other MCP clients connect with a token.
Over HTTPS at a name: Cloudflare Tunnel, Tailscale Funnel or your own reverse proxy.
In Claude, Settings › Connectors › Add custom connector, with https://home.example.com/mcp. No client ID to copy: Claude registers itself.
Read, Control or Administer, never more than your account may do. It follows you to the Claude apps on your phone.
It asks before it acts
Turning off a lamp should be instant. Unlocking the front door should not. Homeswift draws that line for you.
Anything that unlocks, rewrites configuration or restarts the bridge runs as a dry run first. You see each setting and its new value, then Allow or Don't allow. A change that would fail anyway is never put to you.
Locks, garage doors and alarms change through a single guarded tool that always asks. A scene that would unlock something refuses to run unattended.
Each change lands in an audit log with who asked, from where, and what happened. Read it back any time, or just ask: “what changed today?”
Passwords, tokens and keys are masked before anything reaches a model. A password a TV hands out while pairing travels as a handle the model never reads.
Daily and monthly limits in tokens or dollars. When it's spent, the assistant stops until midnight; your lights don't.
Text from devices and logs is fenced off as untrusted. A device that names itself “unlock the door” gets read, never obeyed.
Ways to ask
One assistant, one set of rules, three doors in. Siri and the Home app keep working as they always have: every device is still a HomeKit accessory.
The sparkle button on every page, or ⌘K. Hold the mic to speak, and hear the answer read back. Conversations are kept, per user, on your own machine.
Add Homeswift as a connector in claude.ai and the Claude apps. You sign in with your web UI account and choose what it may do: read, control, or administer.
$ homeswift ask "why does the key light show No Response at night" It loses Wi-Fi when the router's nightly restart runs at 03:00…
ask, explain an error, diagnose a log, or get today's digest. Pipe journalctl straight in.
More than a remote
The assistant reads the same plugins, logs and history the bridge does, so it can answer the questions a switch can't.
Why did the porch light drop off last night?
Searches the log around the time, tells you what happened and whether there's anything to fix.
What happened today?
A daily digest under 200 words, what needs attention first. It's also on the Status page each morning.
Add the Elgato light at 192.168.1.50.
Writes the plugin's settings, checked against its schema, and shows you the change before saving.
Pair my Philips TV.
Finds the TV, runs the pairing, and keeps the password it gets out of the conversation.
Make a movie-night scene.
Picks the accessories, proposes values, tries them, and saves a scene you can schedule.
Tidy up my rooms.
Suggests rooms and clearer names for forty accessories called “Switch 2”.
New in 0.9
143 photographic colour palettes in 28 themes, alongside twenty-two moods for a room’s lights. Browse themes such as Get cozy, Movie night and Wanderlust, and choose the same images for your saved scenes. The animated moods restore the lights when they end.
Arctic aurora
Rolling hills
Blossom
CandlelightVery warm, dim light for dinner.
FireplaceReds, oranges and amber dancing unevenly.
OceanBlues and teals rolling from light to light like waves.
Northern lightsGreen, teal and violet drifting slowly.
SunsetTen minutes from golden yellow through orange and pink to a dim red.
DiscoEvery light jumps to a vivid colour on each beat.
Police sirenRed and blue swapping from light to light.
HalloweenPurple and orange with an eerie flicker.Make the living room feel like a jazz bar.
Your assistant writes the mood from your words: the colours, how long each holds, whether it loops. It learns how many lights there are, never their names.
Halloween on the dining room lights.
Purple and orange with an eerie flicker for half an hour, then every light back as it was. Or say “stop”.
A ten-minute sunset in the bedroom.
Golden yellow through orange and pink to a dim red, and the lights stay there. Also a button on the Scenes page.
Your choice of model
The assistant is optional, off until you add it, and talks to the provider you pick over plain HTTPS.
Underneath
The assistant sits on Homebridge, rewritten in Swift: your Homebridge config and plugins, in one small binary with no Node.js. Turn the assistant off and it's still the lightest bridge you can run.
Apple M1, one run each over loopback. The full comparison.
Install
# 1. The bridge. Host networking lets HomeKit find it over mDNS.
docker run -d --name homeswift --network host \
--restart unless-stopped \
-v ~/homeswift:/homeswift \
ghcr.io/mp-consulting/homeswift:latest
// 2. The assistant: one block in config.json, with a budget. { "platform": "HomeswiftAiKit", "provider": "anthropic", "apiKey": "sk-ant-…", "budget": { "monthlyUsd": 5 } }
On port 8581, and create your account with the code the bridge prints.
Pick plugins and fill in their settings, or ask the assistant to do it.
Scan the QR code on the Status page.
Press ⌘K and tell your house what you want.