Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Plan To Eat

by alex-zwingliversion 0.8.0i★ 2iRuns on your computerRepository ↗
Registry nameio.github.alex-zwingli/plan-to-eat

How to install

What it does

Unofficial Plan to Eat client: recipes, meal planner, leftovers, freezer, and shopping list.

  • Connects Runs on your computer
  • Account or key Needs PLAN_TO_EAT_PASSWORD · 1 setting to fill in (PLAN_TO_EAT_USERNAME)
  • Category Online shops & payments

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity6/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness7/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score13/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Plan To Eat. Follow https://mcp.popnx.com/i/alex-zwingli-plan-to-eat.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Plan To Eat key (create it on the maker’s site) · 1 setting(s) to fill in (PLAN_TO_EAT_USERNAME) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Plan To Eat for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "plan-to-eat": { "command": "npx", "args": [ "-y", "plan-to-eat-mcp" ], "env": { "PLAN_TO_EAT_USERNAME": "your-value", "PLAN_TO_EAT_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For PLAN_TO_EAT_PASSWORD, PLAN_TO_EAT_USERNAME, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Plan To Eat tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Plan To Eat key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • PLAN_TO_EAT_USERNAME Plan to Eat login email

    Descriptions are as written by the maker.

  4. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  5. Paste these settings and save the file

    {
      "mcpServers": {
        "plan-to-eat": {
          "command": "npx",
          "args": [
            "-y",
            "plan-to-eat-mcp"
          ],
          "env": {
            "PLAN_TO_EAT_USERNAME": "your-value",
            "PLAN_TO_EAT_PASSWORD": "your-value"
          }
        }
      }
    }

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Quit Claude and open it again

  7. Try it

    Use Plan To Eat and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Plan To Eat or shows a Plan To Eat tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • PLAN_TO_EAT_SESSION_FILE Where the cookie session is cached. Set to "" to disable caching.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Plan To Eat yet

Plan To Eat runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Plan To Eat

  • You need a Plan To Eat key (create it on the maker’s site) · 1 setting(s) to fill in (PLAN_TO_EAT_USERNAME) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a Plan To Eat key (create it on the maker’s site) · 1 setting(s) to fill in (PLAN_TO_EAT_USERNAME) · Install Node.js on your computer first (one time)
  • You need a Plan To Eat key (create it on the maker’s site) · 1 setting(s) to fill in (PLAN_TO_EAT_USERNAME) · Install Node.js on your computer first (one time)
  • You need a Plan To Eat key (create it on the maker’s site) · 1 setting(s) to fill in (PLAN_TO_EAT_USERNAME) · Install Node.js on your computer first (one time)

B · Others in Online shops & payments that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a Plan To Eat key (create it on the maker’s site) · 1 setting(s) to fill in (PLAN_TO_EAT_USERNAME) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Plan To Eat for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user plan-to-eat --env PLAN_TO_EAT_USERNAME=your-value --env PLAN_TO_EAT_PASSWORD=your-value -- npx -y plan-to-eat-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For PLAN_TO_EAT_PASSWORD, PLAN_TO_EAT_USERNAME, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Plan To Eat tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Plan To Eat key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • PLAN_TO_EAT_USERNAME Plan to Eat login email

    Descriptions are as written by the maker.

  4. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  5. Paste this command and press Enter

    claude mcp add --scope user plan-to-eat --env PLAN_TO_EAT_USERNAME=your-value --env PLAN_TO_EAT_PASSWORD=your-value -- npx -y plan-to-eat-mcp

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Type /mcp in Claude Code

    You should see Plan To Eat listed as connected

  7. Try it

    Use Plan To Eat and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Plan To Eat or shows a Plan To Eat tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • PLAN_TO_EAT_SESSION_FILE Where the cookie session is cached. Set to "" to disable caching.

Descriptions are as written by the maker.

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Plan To Eat key (create it on the maker’s site) · 1 setting(s) to fill in (PLAN_TO_EAT_USERNAME) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Plan To Eat for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "plan-to-eat": { "command": "npx", "args": [ "-y", "plan-to-eat-mcp" ], "env": { "PLAN_TO_EAT_USERNAME": "your-value", "PLAN_TO_EAT_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For PLAN_TO_EAT_PASSWORD, PLAN_TO_EAT_USERNAME, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Plan To Eat tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Plan To Eat key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • PLAN_TO_EAT_USERNAME Plan to Eat login email

    Descriptions are as written by the maker.

  4. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  5. Fill in your key

    In the Plan To Eat settings, PLAN_TO_EAT_PASSWORD, PLAN_TO_EAT_USERNAME is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Open the AI chat in Cursor in Agent mode

  7. Try it

    Use Plan To Eat and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Plan To Eat or shows a Plan To Eat tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • PLAN_TO_EAT_SESSION_FILE Where the cookie session is cached. Set to "" to disable caching.

Descriptions are as written by the maker.

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Plan To Eat key (create it on the maker’s site) · 1 setting(s) to fill in (PLAN_TO_EAT_USERNAME) · Install Node.js on your computer first (one time)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Plan To Eat for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "plan-to-eat": { "type": "stdio", "command": "npx", "args": [ "-y", "plan-to-eat-mcp" ], "env": { "PLAN_TO_EAT_USERNAME": "your-value", "PLAN_TO_EAT_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For PLAN_TO_EAT_PASSWORD, PLAN_TO_EAT_USERNAME, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Plan To Eat tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Install Node.js (if you don’t have it)

    Already installed? Check first · Open Terminal, type this command and press Enter

    node -v
    • A version number such as v26.13.1 = installed, skip this step
    • "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
    How to open Terminal

    Mac: press ⌘ + Space, type Terminal, press Enter

    Windows: open Start, type Windows PowerShell, then Open

    Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed

    Open the Node.js download page ↗

    When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v

    Install once; it works for everything that needs Node.js

  2. Sign up and create a Plan To Eat key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  3. Fill in 1 setting(s)

    These are program settings, not keys. No sign-up needed; fill them in as the maker describes.

    • PLAN_TO_EAT_USERNAME Plan to Eat login email

    Descriptions are as written by the maker.

  4. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  5. Fill in your key

    In the Plan To Eat settings, PLAN_TO_EAT_PASSWORD, PLAN_TO_EAT_USERNAME is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  6. Open the AI chat in VS Code in Agent mode

  7. Try it

    Use Plan To Eat and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Plan To Eat or shows a Plan To Eat tool in the answer, you are connected

1 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • PLAN_TO_EAT_SESSION_FILE Where the cookie session is cached. Set to "" to disable caching.

Descriptions are as written by the maker.

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Plan To Eat💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user plan-to-eat --env PLAN_TO_EAT_USERNAME=your-value --env PLAN_TO_EAT_PASSWORD=your-value -- npx -y plan-to-eat-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "plan-to-eat": {
      "command": "npx",
      "args": [
        "-y",
        "plan-to-eat-mcp"
      ],
      "env": {
        "PLAN_TO_EAT_USERNAME": "your-value",
        "PLAN_TO_EAT_PASSWORD": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "plan-to-eat": {
      "command": "npx",
      "args": [
        "-y",
        "plan-to-eat-mcp"
      ],
      "env": {
        "PLAN_TO_EAT_USERNAME": "your-value",
        "PLAN_TO_EAT_PASSWORD": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "plan-to-eat": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "plan-to-eat-mcp"
      ],
      "env": {
        "PLAN_TO_EAT_USERNAME": "your-value",
        "PLAN_TO_EAT_PASSWORD": "your-value"
      }
    }
  }
}

Values you fill in

  • PLAN_TO_EAT_USERNAME required env
    Plan to Eat login email
  • PLAN_TO_EAT_PASSWORD secret required env
    Plan to Eat password
  • PLAN_TO_EAT_SESSION_FILE env
    Where the cookie session is cached. Set to "" to disable caching.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
61/wk
Connection
Runs on your computer
Latest versioni
0.8.0
Published to registryi
Oct 17, 2026
Code last changedi
Oct 17, 2026
Maker
alex-zwingli
Packages
npm: plan-to-eat-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account alex-zwingli, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 33 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for plan-to-eat-mcp@0.8.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/alex-zwingli-plan-to-eat.svg)](https://mcp.popnx.com/en/servers/alex-zwingli-plan-to-eat)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Online shops & paymentsi

  • More stars than 94% of the other 2947 servers in this category
  • Published to the registry more recently than 46% of the other 2947 servers in this category
  • Basic checks equal to or better than 99% of the other 2947 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Plan To Eat safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: PLAN_TO_EAT_PASSWORD

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 33 days ago, and the latest version (0.8.0) reached the registry 33 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Stripe MCP

Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.

by stripeWidely used★ 2.1KUpdated 13 months ago

Runs in the cloud✓ service owner · stripe.com

flightclaw

Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.

by flightclawGrowing★ 86Updated 2 months ago

Runs in the cloud✓ service owner · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

by trade-it-incEarly★ 62Updated 34 days ago

Runs in the cloud✓ service owner · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

by idealoEarly★ 28Updated 6 months ago

Runs in the cloud✓ service owner · mcp.idealo.com
Compared with similar ones
This one
Plan To Eat
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoYesNoNoNoNo
Basic checks3/34/44/45/54/44/4
LicenseMITMITMITCC0-1.0MITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

🍽️ plan-to-eat-mcp

Stop typing recipes. Start telling them.

Hand your favorite LLM the keys to your Plan to Eat recipe book, planner,

and shopping list — over the Model Context Protocol.

A drop-in MCP server, a CLI, and a standalone Node client that give Claude, ChatGPT, any MCP-aware assistant, or your own shell full read/write access to your Plan to Eat account.

You:  "Save the Bon Appétit miso pasta from this URL and tag it weeknight."

LLM: ✓ created recipe #48,872,094 — 7 ingredients, 25 min, tagged weeknight.

You: "Plan dinner around it Tuesday and add the missing pantry items to my shopping list." LLM: ✓ event created 2026-05-05 / dinner / 4 servings. ✓ shopping list now reflects miso, mirin, and dashi.

…or, when you'd rather not talk to anything:

$ plan-to-eat get-planner-week 2026-05-04

start_date 2026-05-04 end_date 2026-05-10

ID DATE SECTION KIND RECIPE_ID RECIPE_TITLE DESCRIPTION SERVINGS ──────── ────────── ───────── ────────── ───────── ────────────────── ───────────────────── ──────── 67698872 2026-05-05 breakfast recipe 17314561 Breakfast Sandwich 8 67483177 2026-05-05 dinner ingredient Asparagus (in season) 0 67710784 2026-05-06 dinner note Cucumber salad 0

3 rows

That's it. No recipe re-typing. No copy-pasting URLs into a phone app. Just talk.


❤️ Why Plan to Eat?

If you're not already using it, Plan to Eat is genuinely the best meal-planning app I've ever used:

  • A clip-anywhere recipe importer that actually works on real-world food blogs.
  • Drag-and-drop weekly planner that automatically rolls ingredients into a shopping list, with smart units and pantry deduplication.
  • Yours forever — your recipe book is portable, exportable, and not held hostage by an algorithm.
  • Family-friendly — share recipes and menus with friends in-app.
  • 14-day free trial, no credit card needed.

👉 [Sign up with my referral link](https://www.plantoeat.com/ref/d7d2327524) — you get the trial, and I get a tiny thank-you. Win/win.


✨ What this gives you

  • 🤖 MCP server out of the box — point Claude Desktop, Claude Code, OpenClaw, or any MCP-compatible host at it and start talking to your recipe book.
  • ⌨️ A CLI over the same tools — every MCP tool is also a plan-to-eat subcommand, with tables for humans and --json for scripts. One registry feeds both surfaces, so they can't drift.
  • 🔐 Auto-auth & auto-recovery — set your credentials once, the server handles login, caches the cookie session to disk, and silently re-auths whenever Plan to Eat invalidates it.
  • 🧰 36 tools, all the verbs that matter — full recipe CRUD, full meal-planner CRUD (add / move / duplicate / delete recipes, notes, and ingredient entries), reorder events in a slot, leftovers as a first-class workflow, freezer tracking, browse courses & cuisines & tags, count what's in your queue.
  • 🗓️ Real planner control — view a week's plan with recipe titles pre-joined, schedule recipes on dates, attach prep notes, reschedule with one tool call, change servings, duplicate, search for duplicates, reorder same-slot events.
  • 🛒 A shopping list you can actually work with — read it with the store and aisle each item is filed under, add items (Plan to Eat guesses the aisle and reuses the store you last picked), retitle or re-quantify a line, move items between stores, remove them, put them back.
  • ❄️ Freezer tracking — after cooking, mark N portions as frozen with freeze_recipe_portions; check what's stashed with list_frozen_recipes; consume entries when you eat them (soft-delete, history preserved).
  • 🍳 Real CRUD — including ingredient lists with proper units, directions, prep/cook times, nutrition, ratings, and tags.
  • 📦 Tiny runtime — no Playwright, no headless browser, no native modules. Just fetch, the MCP SDK, and Zod. Boots in under a second.
  • 🦺 100% TypeScript — fully typed Recipe, Ingredient, PlannerEvent shapes plus a generic _json so your tools never have to guess what comes back.
  • 📚 A library too — core/client.ts is a clean, plain-Node API client you can drop into any script.
  • 🧠 Bundled Claude Code skill — .claude/skills/plan-to-eat/SKILL.md teaches any agent the common workflows and gotchas (the supper-vs-dinner alias, the description-vs-title mismatch, etc.) so it doesn't have to rediscover them.

Reverse-engineered from the live web app. There's no public Plan to Eat API,

but the desktop site uses these same endpoints internally. Use at your own

risk — they could change anything at any time.


🚀 Quick start

npx -y plan-to-eat-mcp          # run the MCP server

npm i -g plan-to-eat-mcp # …or install both bins on PATH

Requires Node 18+ (for built-in fetch) and a Plan to Eat account.

The package ships two bins: plan-to-eat-mcp (the MCP server) and plan-to-eat (the CLI). To run the CLI through npx without installing, note that you have to select it explicitly, since the default bin is the server:

npx -y -p plan-to-eat-mcp plan-to-eat --help

Building from a clone instead (for development, or the Claude Code plugin)

git clone https://github.com/alex-zwingli/plan-to-eat-mcp.git

cd plan-to-eat-mcp npm install npm run build

The build emits CommonJS to dist/.

Configuration
VarRequiredDefaultDescription
PLAN_TO_EAT_USERNAMEyes—Plan to Eat login email
PLAN_TO_EAT_PASSWORDyes—Plan to Eat password
PLAN_TO_EAT_SESSION_FILEno~/.plan-to-eat-session.jsonWhere the cookie session is cached. Set to "" to disable caching.

The CLI also reads a .env in the working directory (shell variables win). The MCP server does not — MCP hosts pass env explicitly, as shown below.


🤖 Use it with an agent

Any host that can launch a local stdio MCP server works. The server needs one command, two env vars, and nothing else — no ports, no OAuth, no daemon.

Claude Code, the easy way: install the plugin

The repo ships as a Claude Code plugin — MCP server *and* both skills in one step:

export PLAN_TO_EAT_USERNAME=you@example.com

export PLAN_TO_EAT_PASSWORD=hunter2

git clone https://github.com/alex-zwingli/plan-to-eat-mcp.git cd plan-to-eat-mcp && npm install && npm run build

claude plugin marketplace add "$(pwd)" claude plugin install plan-to-eat@plan-to-eat

That gives you:

ComponentWhat it is
MCP server plan-to-eatall 36 tools
Skill plan-to-eathow to *use* the MCP tools well — workflows and gotchas
Skill plan-to-eat-clithe same, for agents driving the CLI instead

Confirm with claude plugin details plan-to-eat@plan-to-eat and claude mcp list. The server reads PLAN_TO_EAT_USERNAME / PLAN_TO_EAT_PASSWORD from the environment Claude Code was launched with, so export them in your shell profile rather than committing them anywhere.

Claude Code, manually
claude mcp add plan-to-eat \

--env PLAN_TO_EAT_USERNAME=you@example.com \ --env PLAN_TO_EAT_PASSWORD=hunter2 \ -- npx -y plan-to-eat-mcp

Add --scope user to make it available in every project instead of just this one. Check it connected with claude mcp list, or /mcp inside a session.

Claude Desktop

Edit claude_desktop_config.json — Settings → Developer → Edit Config, or:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{

"mcpServers": { "plan-to-eat": { "command": "npx", "args": ["-y", "plan-to-eat-mcp"], "env": { "PLAN_TO_EAT_USERNAME": "you@example.com", "PLAN_TO_EAT_PASSWORD": "hunter2" } } } }

Restart Claude Desktop, and you're cooking.

Any other MCP host

Cursor, Windsurf, Zed, Cline, Continue, OpenClaw, VS Code's MCP support, and custom SDK clients all take the same three things. Point them at:

FieldValue
Transportstdio
Commandnpx
Args["-y", "plan-to-eat-mcp"]
EnvPLAN_TO_EAT_USERNAME, PLAN_TO_EAT_PASSWORD

Most of them use the same mcpServers JSON block as Claude Desktop above — often in .cursor/mcp.json, .vscode/mcp.json, or the host's settings UI.

If you installed globally (npm i -g plan-to-eat-mcp), use the plan-to-eat-mcp bin as the command and drop the args entirely. If you built from a clone, the command is node with ["/absolute/path/to/plan-to-eat-mcp/dist/mcp/server.js"].

Absolute paths matter for the clone route. MCP hosts don't launch servers

from your project directory, so a relative path will fail to resolve. The

npx command above sidesteps this entirely.

Verify it works
PLAN_TO_EAT_USERNAME=you@example.com PLAN_TO_EAT_PASSWORD=hunter2 npx -y plan-to-eat-mcp

You should see [plan-to-eat] mcp server ready on stdio (36 tools) on stderr. That's the server waiting for a client — Ctrl-C out. If instead you get a credentials error, fix that before wiring up a host, where the failure is harder to see.

Teach your agent the workflows

Two skills ship in .claude/skills/, covering the common flows and the sharp edges (the supper-vs-dinner alias, the description-vs-title mismatch on note entries, checking for duplicates before scheduling):

  • `plan-to-eat` — for agents calling the MCP tools.
  • `plan-to-eat-cli` — for agents that have a shell but no MCP server. Same 30 capabilities, driven through subcommands, with --json for parsing.

The plugin install above registers both. Agents on other hosts can read them as plain context — point them at the files, or paste one into your system prompt.

Or install just the skills, into any of 18+ agents, with the skills.sh CLI:

npx skills add alex-zwingli/plan-to-eat-mcp

That copies both SKILL.md files into .agents/skills/ and symlinks them for Claude Code, Cursor, Codex, Copilot, Gemini CLI and the rest. Add --skill plan-to-eat-cli to take only one. Note that this installs the *skills* and not the server — each skill's setup section walks the agent through building the MCP server or CLI if it isn't already there.

For OpenClaw agents, both skills are on ClawHub:

clawhub install plan-to-eat        # MCP tools

clawhub install plan-to-eat-cli # shell / CLI

Their frontmatter declares the credentials and binaries each one needs under metadata.openclaw, so ClawHub can check your environment at install time.


⌨️ Use it from the terminal

Every MCP tool is also a subcommand. Underscores become dashes; both spellings work.

npm i -g plan-to-eat-mcp

plan-to-eat --help

Or without installing — note the -p, since the package's default bin is the MCP server, not the CLI:

npx -y -p plan-to-eat-mcp plan-to-eat --help
$ plan-to-eat list-frozen-recipes

ID RECIPE_ID COUNT SERVINGS FROZEN_ON ────── ───────── ───── ──────── ────────── 227854 44676380 6 1.0 2025-05-04 227908 17314561 3 1.0 2025-05-05

2 rows

$ plan-to-eat add-planner-note "Defrost chicken" 2026-05-05 dinner id 67710999 date 2026-05-05 section dinner

$ plan-to-eat get-counts --json | jq .frozen 10

  • Positional or flagged — get-recipe 123 and get-recipe --id 123 are the same. --help lists which arguments are positional.
  • **--json*

Only the beginning is shown; read the rest in the repo