För utvecklare

Visa hushållets sysslor på en skärm i hallen, bocka av dem med en knapp i hemautomationen eller låt ett skript lägga till dem. Rut har samma API som appen använder.

Rut i AI-assistenter

Rut har en MCP-server på https://rut-app.se/mcp. Lägg till den i Claude, ChatGPT eller någon annan assistent som tar MCP-servrar, och fråga vad som ska göras i dag, be den bocka av disken eller skriva upp mjölk på inköpslistan.

Claude: Settings → Connectors → Add custom connector, med adressen ovan. I Claude Code: claude mcp add --transport http rut https://rut-app.se/mcp.
Andra assistenter: lägg till en fjärr-MCP-server med adressen ovan och OAuth-inloggning.

Assistenten skickar dig till Rut för att logga in, och du väljer om den får ändra saker eller bara läsa. Sedan agerar den som du, med din roll i hushållet. Koppla från den under Konto i webbappen.

Egna MCP-klienter kan också använda en API-nyckel som bearer-token i stället för att logga in.

API-nycklar

En admin i hushållet skapar nycklar i webbappen: Hemmet → API-nycklar. En nyckel agerar som admin som skapade den, så länge hen är admin. Kopiera nyckeln när du skapar den, den visas inte igen.

Läsa-nycklar läser sysslor, rum, poäng, historik, anteckningar och hushållets medlemmar.
Läsa och ändra-nycklar kan också bocka av, hoppa över och ångra sysslor, bocka i checklistor, och skapa, ändra och ta bort sysslor, rum och anteckningar.

Ingen nyckel kan hantera medlemmar, inbjudningar, enheter, hushållets inställningar, inloggning eller andra nycklar. Där återkallar du också en nyckel, och då slutar den fungera direkt.

Anropa API:et

API:et är Connect: varje anrop är en POST med JSON till https://rut-app.se/rut.v1.<Service>/<Method>, med nyckeln som bearer-token.

curl https://rut-app.se/rut.v1.ChoreService/ListChores \
  -H "Authorization: Bearer rut_…" \
  -H "Content-Type: application/json" \
  -d '{}'

Några anrop att börja med:

ChoreService/ListChores: alla sysslor med förfallodag, och dagens datum i hushållets tidszon. Sysslor som förfaller idag eller tidigare är de som syns under Idag.
ChoreService/CompleteChore med {"choreId": "…"}: markerar en syssla som gjord, för nyckelns admin om du inte anger creditedMemberIds.
PointsService/GetLeaderboard med {"period": "PERIOD_WEEK"}: veckans poäng, andelar och sviter.
NoteService/ListNotes: hushållets anteckningar.
ChoreService/WatchHousehold: en ström av ändringar medan du är ansluten, för dashboards som uppdateras direkt.

Hela API:et, med alla fält förklarade, finns i .proto-filerna i proto/rut/v1. Med dem genererar buf typade klienter för Go, TypeScript, Swift, Kotlin med flera.

Fel kommer tillbaka som JSON med en code, till exempel unauthenticated (nyckeln är fel eller återkallad), permission_denied (nyckelns behörighet eller adminens roll tillåter det inte) eller failed_precondition (till exempel att sysslan redan är gjord).