Kitchen Timer
Plan a meal and run kitchen timers that ring on your phone. No sign-in.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"kitchen-timer": {
"url": "https://kt.tnyforge.com/mcp/open"
}
}
}Remote endpoints
https://kt.tnyforge.com/mcp/openstreamable-httpWhat it can do
Tool inventory
Tools (8)
🟡plan_meal(dishes, readyInMinutes, readyAt, startNow, timeZone)
Make a meal plan: each dish starts at the right moment so everything is ready at the same time. Returns a link (open it on the phone in the kitchen, where the alarms ring), a QR code for that link, and the schedule. YOU do the cooking knowledge: break a recipe into dishes, each with its total cooking minutes, and put the timed moments inside a dish as steps ("simmer 20, rest 5" is a dish of 25 minutes with a step "Rest" at 20). If the person did not say when they want to eat, ASK before calling; use `readyInMinutes` for "we eat in 90 minutes", `readyAt` (an ISO date-time with a UTC offset, or local time plus `timeZone`) for "at 7", or `startNow` to start cooking now (a single timer is a one-dish plan with `startNow`). Keep times realistic and use only what the person gave you; at most 12 dishes and 12 hours. Dish names are plain text, no links. The reply link works for anyone who has it and the plan is deleted about a day after the meal. Tell the person the alarms ring on the phone page, not in this chat. The reply also holds a secret CONTROL KEY (starts with ktpk_): remember it for the rest of the chat, do not show it or put it in any link, and pass it with the plan's code to the control tools to keep managing this plan. Once it works you may offer the person to manage their whole kitchen from now on (⋯ → Link an agent in the app gives the connector address and a 6-digit code).
Input Schema
{
"type": "object",
"properties": {
"dishes": {
"type": "array",
"minItems": 1,
"maxItems": 12,
"description": "What is being cooked. A single timer is one dish.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Plain text, 80 characters at most. For example \"Roast chicken\"."
},
"minutes": {
"type": "number",
"minimum": 0.1,
"maximum": 720,
"description": "Total cooking time in minutes, from putting it in until it is done."
},
"steps": {
"type": "array",
"maxItems": 8,
"description": "Optional moments inside the cooking time, such as turning or resting.",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "For example \"Turn the chicken\"."
},
"atMinutes": {
"type": "number",
"minimum": 0.1,
"maximum": 720,
"description": "Minutes after this dish goes in; before its total time."
}
},
"required": [
"label",
"atMinutes"
],
"additionalProperties": false
}
}
},
"required": [
"name",
"minutes"
],
"additionalProperties": false
}
},
"readyInMinutes": {
"type": "number",
"minimum": 1,
"maximum": 720,
"description": "Everything ready this many minutes from now. Give exactly one of readyInMinutes, readyAt, startNow."
},
"readyAt": {
"type": [
"string",
"number"
],
"maxLength": 64,
"description": "Everything ready at this time: ISO 8601 with a UTC offset (2026-10-17T19:00:00+01:00), or without an offset when timeZone is given, or epoch milliseconds."
},
"startNow": {
"type": "boolean",
"description": "True: start every dish now (the longest dish sets when it is ready)."
},
"timeZone": {
"type": "string",
"maxLength": 64,
"description": "Optional IANA time zone such as Europe/London. Only used to word the schedule text; the card and the phone show times in the viewer's own clock."
}
},
"required": [
"dishes"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"url": {
"type": "string",
"description": "Open this on the phone in the kitchen."
},
"readyAtMs": {
"type": "integer"
},
"expiresAtMs": {
"type": "integer"
},
"serverNowMs": {
"type": "integer"
},
"dishes": {
"type": "array",
"items": {
"type": "object"
}
},
"schedule": {
"type": "array",
"items": {
"type": "object",
"properties": {
"atMs": {
"type": "integer"
},
"kind": {
"type": "string",
"enum": [
"start",
"step",
"ready"
]
},
"label": {
"type": "string"
}
},
"required": [
"atMs",
"kind",
"label"
]
}
},
"alarms": {
"type": "string"
}
},
"required": [
"code",
"url",
"readyAtMs",
"schedule"
]
}🟢meal_status(code, key)
Say what is next in a meal plan made with plan_meal, and how long until it. Give the plan's code (the last part of its link). Only reads; never changes a plan. Give the control key too, if you have it, to also see the timers on the phone.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The plan's code, or its whole link."
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Optional: the plan's secret control key. With it the answer also says whether the person has started the timers on the phone and what each one is doing."
}
},
"required": [
"code"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"waiting",
"cooking",
"ready"
]
},
"serverNowMs": {
"type": "integer"
},
"readyAtMs": {
"type": "integer"
},
"next": {
"type": [
"object",
"null"
]
},
"upcoming": {
"type": "array",
"items": {
"type": "object"
}
},
"claimed": {
"type": "boolean",
"description": "Only with the key: a phone has tapped Start."
},
"timers": {
"type": "array",
"items": {
"type": "object"
},
"description": "Only with the key, once the phone has started: each dish's state on the phone."
}
},
"required": [
"code",
"state",
"readyAtMs"
]
}⚪pause_meal(code, key)
Pause every dish of this plan that is running on the phone (the cook can resume on the phone or you can call resume_meal). Needs the plan's code and control key. Only works after the person has tapped Start on the phone; before that it says so.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The plan's code, or its whole link."
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
}
},
"required": [
"code",
"key"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
]
}⚪resume_meal(code, key)
Resume the paused dishes of this plan on the phone. Needs the plan's code and control key.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The plan's code, or its whole link."
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
}
},
"required": [
"code",
"key"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
]
}🟡adjust_dish(code, key, dish, minutes)
Add time to a dish (a positive number of minutes) or take time off (negative). Before the person taps Start this changes the plan, and the ready time stays; afterwards it changes that dish's timer on the phone. Needs the plan's code and control key.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The plan's code, or its whole link."
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
},
"dish": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The dish's name as in the plan, or its number in the plan (1 is the first dish)."
},
"minutes": {
"type": "number",
"minimum": -720,
"maximum": 720,
"description": "Minutes to add (positive) or take off (negative), such as 2 or -1.5. Not zero."
}
},
"required": [
"code",
"key",
"dish",
"minutes"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
]
}⚪skip_step(code, key, dish)
Skip the rest of the current wait for one dish: a dish still waiting to go in starts now, and a dish that is cooking finishes now. Only works after the person has tapped Start on the phone. Needs the plan's code and control key.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The plan's code, or its whole link."
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
},
"dish": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The dish's name as in the plan, or its number in the plan (1 is the first dish)."
}
},
"required": [
"code",
"key",
"dish"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
]
}🟡add_dish(code, key, name, minutes, steps)
Add one more dish to this plan. The ready time stays, so the new dish goes in at the ready time minus its cooking time and must still fit. Before the person taps Start it joins the plan on the sheet; afterwards it goes onto the phone too. Same rules as plan_meal: a plain-text name, at most 12 dishes. Needs the plan's code and control key.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The plan's code, or its whole link."
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Plain text, 80 characters at most."
},
"minutes": {
"type": "number",
"minimum": 0.1,
"maximum": 720,
"description": "Total cooking time in minutes."
},
"steps": {
"type": "array",
"maxItems": 8,
"description": "Optional moments inside the cooking time.",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"atMinutes": {
"type": "number",
"minimum": 0.1,
"maximum": 720
}
},
"required": [
"label",
"atMinutes"
],
"additionalProperties": false
}
}
},
"required": [
"code",
"key",
"name",
"minutes"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
]
}🔴cancel_meal(code, key)
Cancel this plan: its link stops working, and if the person already started it, its timers are removed from the phone. Only that plan's timers; nothing else on the phone. Needs the plan's code and control key. Ask the person first.
Input Schema
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The plan's code, or its whole link."
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "The secret control key plan_meal gave you for this plan (starts with ktpk_). Never show it or put it in a link."
}
},
"required": [
"code",
"key"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
},
"required": [
"message"
]
}Community
Evidence