Skip to main content
Glama
craftpip

Kitchen MCP

by craftpip
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

🍳 Kitchen MCP

Your digital kitchen, powered by AI. Track what you have, discover what you can cook, and get guided through every recipe — step by step, timer by timer.

Whether you're a home cook managing a busy kitchen or a developer building AI-powered cooking assistants, Kitchen MCP gives you the structured foundation to make it real.

🔍 What is this?

Kitchen MCP is a local-first Model Context Protocol server that connects an AI assistant to your kitchen. It knows your inventory, your recipes, your equipment, your restrictions, and your preferences — and it helps you cook better with all of it.

The AI never guesses. The server is always the source of truth.

Related MCP server: scraps-kitchen-mcp

✨ Features

Feature

Status

Description

📦 Inventory Management

✅

Track food by lot, location, expiry, and state (sealed, opened, cooked, frozen)

📖 Recipe Engine

✅

Create, version, scale, and validate recipes with ingredients, steps, and equipment

🎯 Smart Matching

✅

Find the best recipes based on what you have, your restrictions, and your taste

👨‍🍳 Cooking Sessions

✅

Start a session, follow guided steps, track ingredient usage, get help when things go wrong

⏱️ Kitchen Timers

✅

Create, pause, resume, and extend timers tied to cooking steps

🚫 Dietary Restrictions

✅

Set allergies, intolerances, religious and ethical restrictions; server blocks unsafe recipes

🌶️ Taste Preferences

✅

Set spice heat, saltiness, sweetness on a 0-10 scale; recipes scored to match

🍞 Equipment Catalog

✅

Register stoves, pressure cookers, mixers, refrigerators; server checks compatibility

⚖️ Unit Conversion

✅

Convert between grams, kilograms, milliliters, teaspoons, tablespoons, cups, and more

🛒 Shopping Lists

🔜

Generate shopping needs from recipes and current inventory

📅 Meal Planning

🔜

Plan meals for the week based on preferences, expiry, and inventory

⏰ Expiry Tracking

🔜

Get notified before food goes bad, use expiring items first

🚀 Quick Start

📋 Prerequisites

  • Node.js >= 20

  • npm

⬇️ Install

git clone https://github.com/craftpip/kitchen-mcp.git
cd kitchen-mcp
npm install

▶️ Run (stdio)

npm start

🌐 Run (HTTP)

npm run dev -- --http

Server listens on http://0.0.0.0:3100/mcp.

🐳 Docker

docker compose build && docker compose up -d

Data persists in the kitchen-mcp_kitchen-data volume.

🤖 Usage with AI Assistants

Add to your MCP client (like OpenCode, Claude Desktop, etc.):

{
  "mcp": {
    "kitchen": {
      "type": "remote",
      "url": "http://localhost:3100/mcp"
    }
  }
}

Once connected, the AI can:

Ask

What happens

🗄️

"What do I have?"

Checks inventory, shows what's in stock

🍽️

"What can I cook for lunch?"

Matches recipes to your inventory and preferences

👨‍🍳

"Start cooking the egg curry"

Creates session, guides through each step

⏱️

"Set a 10-minute timer"

Creates kitchen timer, tracks it

📦

"Add 1kg of rice to the pantry"

Adds inventory lot with full tracking

🚫

"I'm allergic to peanuts"

Blocks all peanut-containing recipes

🛠️ 66 Tools

Category

🔧

What it does

💚 System

2

Health check, capabilities

🗺️ Locations

3

Rooms, shelves, cabinets, drawers

🥕 Ingredients

4

Catalog, aliases, search

📦 Inventory

7

Lots, transactions, expiry tracking

🍞 Equipment

6

Appliances, calibration, availability

⚖️ Measurements

3

Unit conversion, household containers

📖 Recipes

9

CRUD, versioning, scaling, availability

🚫 Restrictions

3

Allergies, intolerances, dietary rules

🌶️ Preferences

3

Spice heat, saltiness, sweetness

🎯 Matching

1

Recipe scoring engine

👨‍🍳 Sessions

16

Cooking lifecycle, step tracking

⏱️ Timers

9

Kitchen timers with full control

🏗️ Architecture

Kitchen MCP follows a strict principle: the server is the authority.

  • 🗄️ SQLite with WAL mode for reliability

  • 🔒 All state changes go through structured tools

  • 📖 Recipe versions are immutable once used in sessions

  • 📦 Inventory deductions happen via transactions, never direct overwrites

  • 📝 Every action is audit-logged

The AI interprets natural language, picks the right tools, and explains results. The server stores facts, validates requests, and enforces rules. Neither side does the other's job.

🧑‍💻 Development

# Typecheck
npx tsc --noEmit

# Build
npm run build

# Test
npm test

# Dev (HTTP mode)
npm run dev -- --http

📁 Project Structure

src/
├── 🛠️ server/tools/      # 13 tool files, 66 tools
├── 🏗️ domain/            # Services and types per domain
├── ⚙️ infrastructure/    # Database, audit, idempotency, logging
└── 📦 shared/            # Response envelope, errors, IDs, time

📄 License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Kitchen MCP Server

    paulabaal12
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables querying food nutritional information, discovering recipes by ingredients or diet type, getting ingredient substitutions, and receiving personalized food recommendations based on mood and season.
    -

  • scraps-kitchen-mcp

    mitchmolstad
    A
    license
    Not graded
    quality
    C
    maintenance
    Household-aware kitchen brain for AI agents: manage pantry inventory with freshness tracking, shopping lists, recipe collections with cook notes and per-diner ratings, dietary profiles with allergen safety, and kitchen equipment — all through 27 tools with OAuth 2.1 authentication. Includes a free tool for ingredient-based recipe generation without an account (accounts are free!).
    MIT

  • yes_chef_mcp

    ltmorro
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to search recipes, compose nutritionally balanced meals, optimize weekly meal plans based on macro targets for family members, and generate consolidated grocery lists from a personal recipe database.
    -

Appeared in Searches