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.

71 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_bulkVisible to othersCreate a new bulk. Required: shopping list id or items. Has effects visible outside this system.
create_familyChanges dataCreate a new family. Required: name.
create_meal_planChanges dataCreate a new meal plan.
create_parse_htmlChanges dataCreate a new parse html.
create_parse_spokenChanges dataCreate a new parse spoken. Required: utterance.
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.
create_shopping_list_createfromChanges dataCreate a new createfrom for a shopping list. Required: name.
create_tagChanges dataCreate a new tag.
create_userChanges dataCreate a new user. Required: family id or user id to add.
delete_familyDeletesPermanently delete a family by family id. Destructive action; may require approval.
delete_itemDeletesRemove an item from a shopping list by `product_id`. This cannot be undone.
delete_list_shareDeletesPermanently delete a list share by list share id. Destructive action; may require approval.
delete_meal_planDeletesPermanently delete a meal plan by meal plan id. Destructive action; may require approval.
delete_meal_plan_entryDeletesRemove a planned meal by its entry ID (`page_id`). This cannot be undone.
delete_pantryDeletesPermanently delete a pantry by pantry id. Destructive action; may require approval.
delete_previous_item_nameDeletesPermanently delete a previous item name by name. Destructive action; may require approval.
delete_previous_item_namesMoves moneyPermanently delete a previous item name. Financial or irreversible action; may require approval.
delete_recipeDeletesPermanently delete a recipe by recipe id. Destructive action; may require approval.
delete_recipe_tagDeletesPermanently delete a tag by tag id. Destructive action; may require approval.
delete_shopping_listDeletesPermanently delete a shopping list by shopping list id. Destructive action; may require approval.
delete_tagDeletesPermanently delete a tag by tag id. Destructive action; may require approval.
delete_userDeletesPermanently delete a user by user id. Destructive action; may require approval.
find_recipes_from_pantryFind recipes you can make with what is already in your pantry.
get_categoryGet one category by category id.
get_category_getGet one category by category id.
get_familyGet one family by family id.
get_itemGet one shopping list item by `product_id`.
get_list_shareGet one list share by list share id.
get_pantryGet one pantry by pantry id.
get_recipeGet one recipe by `recipe_id`, including ingredients and instructions.
get_shopping_listGet one shopping list by `shopping_list_id`.
get_userGet one user by user id.
import_recipe_from_urlChanges dataImport a recipe from a web page `url` into your recipe collection.
list_categoriesList categories.
list_categories_getList categories. Optional filters: parent category id.
list_familiesList families.
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_previous_item_namesList previous item names.
list_previous_namesList previous names.
list_recipe_pantry_matchesList pantry matches for a recipe.
list_recipesList your recipes, optionally filtered by `tag_ids`.
list_sharesList shares. Optional filters: list id.
list_shares_listChanges dataList shares.
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.
list_usersList users. Optional filters: family id.
move_list_to_pantryChanges dataAdd the checked items from a shopping list (`list_id`) into your pantry stock.
update_familyChanges dataUpdate an existing family identified by family id.
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_meal_planChanges dataUpdate an existing meal plan identified by meal plan id.
update_meal_plan_defaultsVisible to othersUpdate an existing default identified by meal plan id. Has effects visible outside this system.
update_page_addtolistChanges dataUpdate an existing addtolist identified by list id.
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_recipe_tagChanges dataUpdate an existing tag identified by tag id.
update_shopping_listChanges dataRename a shopping list or change whether it is a template, by `shopping_list_id` with the new `name`.
update_tagChanges dataUpdate an existing tag identified by tag id.
upload_pantry_imageChanges dataImport a pantry.
upload_recipe_imageChanges dataImport a recipe.
upload_recipe_paprikaChanges dataImport a recipe.

Set up in three steps

1
Pick the app
Create a free HeyMyApps 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 HeyMyApps 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?

HeyMyApps 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 HeyMyApps.