niiko-mcp-server · Version latest
niiko-mcp-server@2026-10-18
The remote MCP server. Connect Claude or any OAuth-capable client and every action and read you grant becomes a tool, the reads marked read-only.
Last updated
- Published
- UTC
- Registry
- niiko.org/api/mcp
- Source
- vorluno/niiko-mcp-server
Install this version
claude mcp add --transport http niiko https://niiko.org/api/mcpWhat changed around this release
- The SDKs and the CLI read Added
@vorluno/niiko-sdk,niikoandniiko-cli0.3.0 take an OAuth access token (accessToken,access_token=,niiko login --token) and have one read-only method per read:getCollections(),get_collections(),niiko read kiipu.collections_get. A read has two outcomes, done or refused, and takes no idempotency key. - Broadcasts can be declared a promotion Added
miira.broadcast_quotedtakes an optionalpurpose:notice(the default, unchanged) orpromotion. A promotion never goes as free text, even with the 24-hour window open: it needs an approved marketing template (otherwiseplantilla_invalida) and only reaches clients with granted marketing consent (no_marketing_consentotherwise). US numbers are left out with the new row outcomeus_moratorium, which is emitted only for a promotion, so existing integrations never see it. The purpose is signed into the quote. - Declared reads, OAuth only Added
POST /api/v1/reads/{id}answers nine declared reads — what is owed, what was collected, the agenda, the funnel, the month — never raw tables and never text someone wrote. Only with an OAuth token, on behalf of a person and with their role (an API key getsreads_need_a_person); each read has its own workspace switch, off by default. The MCP server lists them as read-only tools. - Broadcasts no longer wait for quiet hours Changedniiko no longer defers or excludes sends by the time of day. Broadcast rows are no longer reported as
quiet_hours(the value stays in the outcome enum, but it is never emitted), and the messages queued bymiira.broadcast_sentgo out right away, at any hour. Meta's 24-hour service window and consent rules are unchanged.