Integration · Productivity

Connect Claude & ChatGPT to Nimblist

Ask your AI to put milk on the shopping list, plan dinners for the week or import a recipe you found online into Nimblist. It can read and update your shopping lists, pantry stock, recipes and meal plans, and it can turn a recipe or a planned week into items on a list.

Connect Nimblist free

Free plan, no credit card. Takes about a minute.

Try asking

“Add eggs, butter and 2 litres of milk to my weekly shopping list.”
The AI finds the list and adds each item, with the quantity where you gave one.
“Import this recipe: https://example.com/lasagne”
It imports the recipe from the web page into your Nimblist recipe collection.
“Put the ingredients for the lasagne recipe on my shopping list, but skip the salt.”
It adds the recipe's ingredients to the list and leaves out the ones you excluded.

What your AI can do

Shopping lists

Create and rename lists, add, update and tick off items, and copy a saved template onto a list.

Recipes and pantry

Create, update and import recipes from a URL, keep pantry stock up to date and find recipes you can make with it.

Meal plans

See planned meals by date, add or remove a meal, and add a whole week's ingredients to a shopping list.

“Plan the lasagne for Thursday dinner.”
It adds an entry to your meal plan on that date with the recipe and meal type.
“What can I cook with what is in the pantry?”
It looks at your pantry stock and returns recipes you can make with it.
“Move everything I ticked off on the shopping list into the pantry.”
It adds the checked items from the list to your pantry stock.

28 tools for Nimblist

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_itemChanges dataAdd an item to a shopping list. Requires `name` and `shopping_list_id`; optionally a `quantity`.
add_meal_plan_entryChanges dataPlan a meal on a date. Requires `meal_plan_id` and `planned_date`; optionally a `recipe_id` or `custom_text`, a `meal_type` and notes.
add_meal_week_to_listChanges dataAdd the ingredients for a week of planned meals to a shopping list. Requires `meal_plan_id`, `week_start` date and `list_id`.
add_pantry_itemChanges dataAdd an item to your pantry stock with a `name` and optional `quantity`.
add_recipe_to_listChanges dataAdd a recipe's ingredients (`recipe_id`) to a shopping list (`list_id`), optionally overriding quantities or excluding some ingredients.
add_template_to_listChanges dataCopy all items from a template (`template_id`) onto a shopping list (`list_id`).
create_recipeChanges dataCreate a recipe with a `title`, `ingredients`, `instructions`, and optional description, yield, total time and source or image URL.
create_shopping_listChanges dataCreate a new shopping list with a `name`; set `is_template` to save it as a reusable template instead.
delete_itemDeletesRemove an item from a shopping list by `product_id`. This cannot be undone.
delete_meal_plan_entryDeletesRemove a planned meal by its entry ID (`page_id`). This cannot be undone.
find_recipes_from_pantryFind recipes you can make with what is already in your pantry.
get_itemGet one shopping list item by `product_id`.
get_recipeGet one recipe by `recipe_id`, including ingredients and instructions.
get_shopping_listGet one shopping list by `shopping_list_id`.
import_recipe_from_urlChanges dataImport a recipe from a web page `url` into your recipe collection.
list_itemsList items on your shopping lists, optionally for one list with `list_id`.
list_list_templatesList your saved shopping list templates.
list_meal_plan_entriesList the planned meals in a meal plan by `meal_plan_id`, optionally between `from` and `to` dates.
list_meal_plansList your meal plans. Use this to find a meal plan's ID.
list_pantry_itemsList the items in your pantry stock.
list_recipesList your recipes, optionally filtered by `tag_ids`.
list_shopping_listsList your shopping lists (optionally limit with `take`). Use this to find a list's ID.
list_tagsList your recipe tags and their IDs.
move_list_to_pantryChanges dataAdd the checked items from a shopping list (`list_id`) into your pantry stock.
update_itemChanges dataUpdate a shopping list item by `product_id`, e.g. tick it off with `is_checked`, change the quantity, or move it to another category. `name` and `shopping_list_id` are required.
update_pantry_itemChanges dataUpdate a pantry item's `name` or `quantity` by `pantry_id`.
update_recipeChanges dataUpdate a recipe by `recipe_id`; only the fields you pass change.
update_shopping_listChanges dataRename a shopping list or change whether it is a template, by `shopping_list_id` with the new `name`.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Nimblist from the app list.
2
Paste your key
Paste a Nimblist API token. In the Nimblist web app open Settings > API tokens, create a token and copy it. It starts with nbl_ and is shown only once.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Nimblist?

It can list and read your shopping lists, items, templates, pantry stock, recipes, recipe tags and meal plans. It can create and update lists, items, pantry items and recipes, import a recipe from a URL, add a recipe or a week of meals to a list, plan meals, and delete an item or a planned meal if you switch those tools on.

Does the AI see my Nimblist credentials?

No. Your Nimblist API token is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Deleting an item or a planned meal is permanent and can require your approval before it runs. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Nimblist account.

Where do I find my Nimblist API token?

In the Nimblist web app, open Settings > API tokens and create a token. It starts with nbl_ and Nimblist shows it only once, so copy it straight into PipMCP.