Documentatie

Verhuisapp MCP-server

Verbind een AI-assistent zoals ChatGPT, Claude of Cursor met je Verhuisapp-huishouden. De MCP-server geeft toegang tot je taken en inkooplijst — namens de ingelogde gebruiker, met dezelfde rechten als in de app.

Verbinden

Voeg de volgende server-URL toe in je AI-client:

https://verhuisregelapp.lovable.app/mcp

De server spreekt MCP Streamable HTTP (spec 2025-06-18). In ChatGPT (Instellingen → Connectors) en Claude Desktop plak je de URL en start het OAuth-goedkeuringsscherm automatisch.

Authenticatie

De server gebruikt OAuth 2.1 met dynamische client-registratie. Bij het eerste verzoek:

Je client registreert zichzelf en start een autorisatie-flow.
Je logt in met je Verhuisapp-account.
Je ziet een toestemmingsscherm ("Verbind X met je account") — kies Toestaan.
De client ontvangt een token en kan tools aanroepen.

Alle tools werken met jouw rechten: je ziet alleen data van het huishouden waar je bij hoort. Andere huishoudens zijn onbereikbaar (RLS).

list_tasks— Lijst taken

Haalt taken op uit jouw huishouden. Zonder filter krijg je de eerstvolgende 50 taken, gesorteerd op deadline.

Parameters

Naam	Type	Verplicht	Toelichting
status	"te_doen" \| "bezig" \| "klaar"	nee	Filter op status.
limit	integer (1–200)	nee	Max aantal taken. Default 50.

Voorbeeld-request

{
  "name": "list_tasks",
  "arguments": {
    "status": "te_doen",
    "limit": 10
  }
}

Voorbeeld-response

{
  "tasks": [
    {
      "id": "5a1b…",
      "title": "Adres wijzigen bij gemeente",
      "category": "Administratie",
      "status": "te_doen",
      "priority": "hoog",
      "deadline": "2026-07-20",
      "assignee": "jasper",
      "note": null
    }
  ]
}

create_task— Maak taak

Voegt een nieuwe taak toe aan jouw huishouden. Titel en categorie zijn verplicht.

Parameters

Naam	Type	Verplicht	Toelichting
title	string	ja	Titel van de taak.
category	string	ja	Bijv. 'Administratie' of 'Klussen'.
priority	"hoog" \| "normaal" \| "laag"	nee	Default: normaal.
deadline	string (YYYY-MM-DD)	nee	Optionele deadline.
assignee	"jasper" \| "mira" \| "samen"	nee	Wie doet het?
note	string	nee	Extra opmerking.

Voorbeeld-request

{
  "name": "create_task",
  "arguments": {
    "title": "Meterstanden doorgeven",
    "category": "Administratie",
    "priority": "hoog",
    "deadline": "2026-07-15",
    "assignee": "samen"
  }
}

Voorbeeld-response

{
  "task": {
    "id": "8f2c…",
    "title": "Meterstanden doorgeven",
    "category": "Administratie",
    "priority": "hoog",
    "status": "te_doen",
    "deadline": "2026-07-15",
    "assignee": "samen"
  }
}

complete_task— Markeer taak als klaar

Zet de status van een taak op 'klaar'. Idempotent — opnieuw uitvoeren op een afgeronde taak is veilig.

Parameters

Naam	Type	Verplicht	Toelichting
task_id	uuid	ja	ID zoals teruggegeven door list_tasks.

Voorbeeld-request

{
  "name": "complete_task",
  "arguments": {
    "task_id": "5a1b8c2e-…"
  }
}

Voorbeeld-response

{
  "task": {
    "id": "5a1b8c2e-…",
    "title": "Adres wijzigen bij gemeente",
    "status": "klaar"
  }
}

Overige tools

De server biedt daarnaast list_shopping_items en add_shopping_item voor de inkooplijst. De parameters volgen dezelfde stijl als de taak-tools; je AI-client toont ze automatisch na verbinden.

Foutcodes

Niet geauthenticeerd — je token is verlopen; laat je client opnieuw autoriseren.
Geen huishouden gevonden — je account zit nog niet in een huishouden. Log in op de app en maak of join er één.
Andere fouten worden letterlijk teruggegeven vanuit de database (bijv. validatiefouten).

MCP-endpoint: https://verhuisregelapp.lovable.app/mcp