Get started

Nipto API

Read and log the chores of your crew from Home Assistant or your own scripts with the Nipto GraphQL API.

Nipto turns household chores into a weekly game for the whole crew. The Nipto API lets your smart home, dashboards and scripts read that game and play it: who did what this week, the eggs and levels of each member, the Planning, the gems and the shop, and logging a task the moment it is done.

Endpoint

It is a GraphQL API with a single endpoint. Send a POST with a JSON body holding a query (and optional variables):

POST https://nipto.app/graphql
Content-Type: application/json
Authorization: YOUR_TOKEN

A raw GraphQL body with Content-Type: application/graphql works too, and so do GET requests with a query parameter. Several operations can be sent at once as a JSON array. Opening the endpoint in a browser shows an explorer where you can try queries.

Your first call

Get your token in the app (see Authentication), then list the members of your crew:

curl https://nipto.app/graphql \
  -H 'Content-Type: application/json' \
  -H 'Authorization: YOUR_TOKEN' \
  -d '{"query":"{ users { uid name objective } }"}'

Answer

{
  "data": {
    "users": [
      { "uid": "IjKLw2GSVWbmWYFYOyApPgEw6X82", "name": "Camille", "objective": null },
      { "uid": "q6Rz7RHjW7YJtwv9xVZI69LKC4s1", "name": "Léo", "objective": 90 }
    ]
  }
}

What you can do

To	Use
List the members of the crew	`users`
List the tasks and what each one is worth in eggs	`tasks`
See what was done this week	`activities`
Read past weeks: eggs, levels, streaks	`weeks`
Read the Planning	`reminders`
Read the gems and the shop	`wallets`, `rewards`, `purchases`
Log a task as done	`createActivity`
Remove an activity of this week	`deleteActivity`
Plan a task, once or repeating	`createReminder`

Before you start

The API is for Premium crews. See Premium.
Each token allows 2,000 calls a day. See Rate limits.
Dates come back in UTC. A date alone sent as an argument, like "2026-03-15", means that day where your crew lives, and times of day and weeks follow the time zone of your crew too. See Time zones.
The app talks about eggs, levels and the crew, the API about points, results and the team. See Vocabulary.
Ready-made setup: Home Assistant.
MCP server: https://nipto.app/mcp, with OAuth 2.1 sign-in or a token sent as Authorization: Bearer YOUR_TOKEN.

Stability

Automations built on the API keep working: fields are added, never removed or renamed. A field that should no longer be used is marked deprecated in the reference and keeps answering. Questions or problems: write to support@nipto.app.