Renovatieplanner MCP

Koppel je AI-assistent (Claude, ChatGPT of een andere MCP-client) aan Renovatieplanner en vraag in gewone taal naar projecten, woningen, taken, inspecties en formulieren — met je eigen account en rechten.

Koppelen

Dit is het MCP-endpoint (Streamable HTTP, OAuth 2.1):

https://mcp.renovatieplanner.nl/mcp

Claude: Settings → Connectors → Add custom connector → plak het adres.
Claude Code: claude mcp add --transport http renovatieplanner https://mcp.renovatieplanner.nl/mcp
MCP Inspector: npx @modelcontextprotocol/inspector → Streamable HTTP → dit adres.

Na het toevoegen log je in met je Renovatieplanner-account (inclusief tweestapsverificatie). Toegang vereist de module AI-koppeling (MCP) voor jouw organisatie. OAuth-discovery: authorization-server · protected-resource

Tools (18)

search_projects get_project get_project_metrics list_houses get_house search_residents search_inspections get_inspection get_poi_answers list_form_results get_form_result list_tasks get_task create_task update_task draft_resident_news attach_document_to_project search_changelog

`search_projects` leest

Zoek renovatieprojecten op naam, code of plaats. Geeft een gepagineerde lijst met id, naam, code en status.

Parameter	Type	Omschrijving
`query`	`string`	Zoektekst (naam, code, omschrijving, plaats)
`status`	`'active' \| 'concept' \| 'archived'`	Projectstatus
`limit`	`integer`standaard: 20	Maximaal aantal resultaten
`page`	`integer`standaard: 1	Paginanummer

`get_project` leest

Haal één project op: adres, status, datums, budget en instellingen.

Parameter	Type	Omschrijving
`project_id` verplicht	`integer`	Id van het project

`get_project_metrics` leest

Dashboardcijfers van één project: woningaantallen, inspectievoortgang, taakaantallen en andere kerncijfers.

Parameter	Type	Omschrijving
`project_id` verplicht	`integer`	Id van het project

`list_houses` leest

Woningen (objecten) van een project, inclusief de woningcode voor de bewonersapp en de naam van de hoofdbewoner.

Parameter	Type	Omschrijving
`project_id` verplicht	`integer`	Id van het project

`get_house` leest

Haal één woning op — op id óf op woningcode — inclusief de bewoners. Geef precies één van beide mee.

Parameter	Type	Omschrijving
`house_id`	`integer`	Id van de woning
`house_code`	`string`	Woningcode (bewonersapp)

`search_residents` leest

Zoek bewoners binnen een project op naam. Geeft de gevonden woningen met bewonersnaam en adres.

Parameter	Type	Omschrijving
`project_id` verplicht	`integer`	Id van het project
`query` verplicht	`string`	Deel van de bewonersnaam

`search_inspections` leest

Inspecties en registraties van een project (per woning, met status).

Parameter	Type	Omschrijving
`project_id` verplicht	`integer`	Id van het project

`get_inspection` leest

Haal één inspectie op, inclusief locaties en voortgang.

Parameter	Type	Omschrijving
`inspection_id` verplicht	`integer`	Id van de inspectie

`get_poi_answers` leest

Maatregel-antwoorden (POI) van inspecties/registraties in een project: vraag, categorie, waarde en afmetingen per antwoord. Optioneel filteren op woning, categorie of vraag.

Parameter	Type	Omschrijving
`project_id` verplicht	`integer`	Id van het project
`house_id`	`integer`	Beperk tot één woning
`category_id`	`integer`	Beperk tot één vraagcategorie
`question_id`	`integer`	Beperk tot één vraag
`limit`	`integer`standaard: 100	Maximaal aantal antwoorden

`list_form_results` leest

Ingevulde formulierresultaten. Filter op project, woning of formulier (minstens één filter verplicht).

Parameter	Type	Omschrijving
`project_id`	`integer`	Id van het project
`house_id`	`integer`	Id van de woning
`form_id`	`integer`	Id van het formulier
`page`	`integer`standaard: 1	Paginanummer
`limit`	`integer`standaard: 20	Maximaal aantal resultaten

`get_form_result` leest

Haal één formulierresultaat op: de volledige formulierstructuur met alle antwoorden, foto’s en bestanden.

Parameter	Type	Omschrijving
`result_id` verplicht	`integer`	Id van het formulierresultaat

`list_tasks` leest

Taken van een project met filters (status, zoektekst, uitvoerder, einddatum-bereik). Gepagineerd, met datums, status, woningen en uitvoerder.

Parameter	Type	Omschrijving
`project_id` verplicht	`integer`	Id van het project
`status`	`'new' \| 'planned' \| 'in_progress' \| 'done'`	Taakstatus
`search`	`string`	Zoektekst
`assignee_id`	`integer`	Id van de uitvoerder
`due_from`	`string`	Einddatum vanaf (JJJJ-MM-DD)
`due_to`	`string`	Einddatum tot en met (JJJJ-MM-DD)
`page`	`integer`standaard: 1	Paginanummer
`limit`	`integer`standaard: 25	Maximaal aantal taken

`get_task` leest

Haal één taak op, inclusief omschrijving, datums, woningen, uitvoerder en status.

Parameter	Type	Omschrijving
`task_id` verplicht	`integer`	Id van de taak

`create_task` schrijft

Maak een taak aan in een project. Datums zijn optioneel; de duur is in werkdagen en de einddatum berekent Renovatieplanner zelf. Optioneel met woningen (één instantie per woning) en een uitvoerder.

Parameter	Type	Omschrijving
`project_id` verplicht	`integer`	Id van het project
`name` verplicht	`string`	Naam van de taak
`description`	`string`	Omschrijving
`start_date`	`string`	Startdatum (JJJJ-MM-DD)
`duration_days`	`integer`	Duur in werkdagen
`deadline_date`	`string`	Harde deadline (JJJJ-MM-DD)
`house_ids`	`array`	Woning-ids (één taakinstantie per woning)
`assignee_user_id`	`integer`	Id van de uitvoerder

`update_task` schrijft

Werk een taak bij: naam, omschrijving, status, startdatum, duur (werkdagen) of deadline. Geef alleen de velden mee die je wilt wijzigen.

Parameter	Type	Omschrijving
`task_id` verplicht	`integer`	Id van de taak
`name`	`string`	Nieuwe naam
`description`	`string`	Nieuwe omschrijving
`status`	`'new' \| 'planned' \| 'in_progress' \| 'done'`	Nieuwe status
`start_date`	`string`	Nieuwe startdatum (JJJJ-MM-DD)
`duration_days`	`integer`	Nieuwe duur in werkdagen
`deadline_date`	`any`	Nieuwe deadline (JJJJ-MM-DD), of null om te wissen

`draft_resident_news` schrijft

Maak een CONCEPT-bewonersnieuwsbericht voor een project (Nederlandse inhoud; wordt niet gepubliceerd — een gebruiker beoordeelt en publiceert het in Renovatieplanner). Geeft een link naar het concept.

Parameter	Type	Omschrijving
`project_id` verplicht	`integer`	Id van het project
`title` verplicht	`string`	Titel van het bericht
`content` verplicht	`string`	Inhoud (HTML of platte tekst, in het Nederlands)

`attach_document_to_project` schrijft

Upload een document (base64) naar de tab Documenten van een project. Maximaal ±10 MB.

Parameter	Type	Omschrijving
`project_id` verplicht	`integer`	Id van het project
`filename` verplicht	`string`	Bestandsnaam
`content_base64` verplicht	`string`	Bestandsinhoud als base64
`description`	`string`	Omschrijving
`mime_type`	`string`standaard: "application/octet-stream"	MIME-type van het bestand

`search_changelog` leest

Doorzoek de productchangelog van Renovatieplanner: welke release wijzigde wat, en wanneer. Per versie gegroepeerd op rubriek. Zonder filters krijg je de nieuwste releases. Alleen voor superadmins.

Parameter	Type	Omschrijving
`query`	`string`	Zoektekst in de changelogregels
`version`	`string`	Exacte versie, bijv. 1.120.0
`category`	`string`	Rubriek: Toegevoegd, Gewijzigd, Opgelost, Verwijderd, Beveiliging of Verouderd
`since`	`string`	Uitgebracht op of na (JJJJ-MM-DD)
`until`	`string`	Uitgebracht op of vóór (JJJJ-MM-DD)
`limit`	`integer`standaard: 10	Maximaal aantal versies

Koppelen

Tools (18)

search_projects leest

get_project leest

get_project_metrics leest

list_houses leest

get_house leest

search_residents leest

search_inspections leest

get_inspection leest

get_poi_answers leest

list_form_results leest

get_form_result leest

list_tasks leest

get_task leest

create_task schrijft

update_task schrijft

draft_resident_news schrijft

attach_document_to_project schrijft

search_changelog leest