AnyList MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AnyList MCP Server Add the ingredients for my lasagna recipe to the Groceries list"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AnyList MCP Server
A Model Context Protocol (MCP) server that connects AI assistants to AnyList — giving them access to your shopping lists, recipes, and meal plans.
Features
Shopping Lists — View lists, check items, add freeform items or recipe ingredients
Recipes — Search and retrieve full recipe details including ingredients and steps
Meal Planning — View and schedule meals on your AnyList calendar
Grocery Helpers — Add ingredients from one or multiple recipes to a list with duplicate handling
Related MCP server: lista-compras-mcp
Prerequisites
Node.js >= 18
An AnyList account (email/password)
Setup
Clone this repository:
git clone <this-repo> anylist-mcp cd anylist-mcpInstall dependencies:
npm installBuild:
npm run build
Configuration
The server requires your AnyList credentials as environment variables:
Variable | Description |
| Your AnyList account email |
| Your AnyList account password |
Claude Desktop
Add to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"anylist": {
"command": "node",
"args": ["/path/to/anylist-mcp/dist/index.js"],
"env": {
"ANYLIST_EMAIL": "your-email@example.com",
"ANYLIST_PASSWORD": "your-password"
}
}
}
}Other MCP Clients
Run the server via stdio transport:
ANYLIST_EMAIL=you@example.com ANYLIST_PASSWORD=secret node dist/index.jsOr for development:
ANYLIST_EMAIL=you@example.com ANYLIST_PASSWORD=secret npm run devTools
Lists
Tool | Description |
| List all shopping lists with item counts |
| Get all items on a specific list |
| Add a freeform item to a list (with duplicate checking) |
| Add a recipe ingredient to a list with proper categorization |
Recipes
Tool | Description |
| List all recipes, optionally filtered by name |
| Get full recipe details including ingredients and steps |
Groceries
Tool | Description |
| Add all ingredients from a recipe to a list |
| Batch add ingredients from multiple recipes to a list |
Meal Planning
Tool | Description |
| Get meal plan events for a date range (defaults to current week) |
| Schedule a recipe or event on a specific day |
Tool Details
add_item_to_list
Add a freeform item to a shopping list. If the item already exists and is checked off, it will be unchecked instead of duplicated.
item_name(required) — Name of the itemlist_name(required) — Target list namequantity(optional) — e.g. "2 lbs", "3"
add_ingredient_to_list
Add a specific ingredient from a recipe to a shopping list. Uses AnyList's ingredient handler for proper categorization, and matches against existing or recently used items.
recipe_nameorrecipe_id(one required) — The recipe to pull fromingredient_name(required) — Ingredient name (case-insensitive, partial match)list_name(optional, default: "Groceries") — Target list
add_recipe_ingredients_to_list
Add all ingredients from a single recipe to a list. Handles duplicates: skips items already present, unchecks previously checked-off items.
recipe_nameorrecipe_id(one required)list_name(optional, default: "Groceries")
add_ingredients_to_list
Batch version — add ingredients from multiple recipes at once. Deduplicates across recipes.
recipe_namesorrecipe_ids(one required, array)list_name(optional, default: "Groceries")
get_recipe_details
Get full recipe details including ingredients (with name, quantity, and notes) and preparation steps.
recipe_nameorrecipe_id(one required)
add_meal_plan_event
Schedule a recipe or titled event on the meal plan calendar.
date(required) — YYYY-MM-DD formatrecipe_nameorrecipe_id(optional) — Recipe to scheduletitle(optional) — Event title (used if no recipe, or as override)label(optional) — e.g. "Breakfast", "Lunch", "Dinner"
License
ISC
Available Tools
10 toolsadd_ingredients_to_listBatch Add Ingredients to ListA
Add ingredients from multiple recipes to a shopping list at once. Defaults to the "Groceries" list. Handles duplicates across recipes: each ingredient is only added once.
Inputs: recipe_names, recipe_ids, list_name.
add_ingredient_to_listAdd Ingredient to ListA
Add a specific ingredient from a recipe to a shopping list. Matches existing items or recent items by name for proper AnyList categorization.
Inputs: ingredient_name (required), recipe_name, recipe_id, list_name, +2 more.
add_item_to_listAdd Item to ListA
Add a freeform item to a shopping list. Checks for duplicates before adding.
Inputs: item_name (required), list_name (required), quantity.
add_meal_plan_eventAdd Meal Plan EventC
Schedule a recipe or titled event on a specific day in the meal plan calendar.
Inputs: date (required), recipe_name, recipe_id, title, +1 more.
add_recipe_ingredients_to_listAdd Recipe Ingredients to ListA
Add all ingredients from a single recipe to a shopping list. Defaults to the "Groceries" list. Checks for duplicates: skips items already on the list, unchecks previously checked-off items.
Inputs: recipe_name, recipe_id, list_name.
get_list_itemsGet List ItemsB
Get all items on a specific shopping list.
Inputs: list_name (required).
get_listsGet ListsA
List all shopping lists in the AnyList account.
Inputs: no named parameters.
get_meal_planGet Meal PlanA
Get meal plan events for a date range. Defaults to the current week (Mon-Sun). Use a 6-week lookback (e.g. start_date 6 weeks ago) to understand recent eating patterns when recommending new meals.
Inputs: start_date, end_date.
get_recipe_detailsGet Recipe DetailsA
Get full details of a specific recipe including ingredients and preparation steps. Look up by name or ID.
Inputs: recipe_name, recipe_id.
get_recipesGet RecipesA
List all saved recipes from the AnyList account. Returns name, rating, cook time, prep time, and servings for each recipe. Use the optional search parameter to filter by name.
Inputs: search.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
There is significant overlap between tools like add_ingredients_to_list, add_ingredient_to_list, add_recipe_ingredients_to_list, and add_item_to_list, which all add items to shopping lists with subtle distinctions that could confuse an agent. However, the descriptions provide some clarity on their specific use cases, such as handling multiple recipes versus single recipes versus freeform items.
All tool names follow a consistent verb_noun pattern with snake_case, such as add_ingredients_to_list, get_list_items, and get_meal_plan. This predictability makes it easy for an agent to understand and navigate the tool set without confusion.
With 10 tools, the server is well-scoped for managing shopping lists, recipes, and meal plans. Each tool serves a distinct purpose within this domain, and the count is neither too sparse nor overwhelming, fitting typical server ranges of 3-15 tools.
The tool set covers core operations for shopping lists (add, get), recipes (get details, list), and meal plans (add events, get plan), with minor gaps such as missing update or delete functions for items, lists, or recipes. Agents can likely work around these omissions, but they represent a slight limitation in lifecycle coverage.
Maintenance
Related MCP Connectors
AnyList MCP server for ChatGPT, Claude and any AI agent: list shopping lists, add list item, cross off item, read recipe, create recipe, add recipe to meal plan and add meal plan ingredients to list in your own AnyList account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to AnyList yourself; Cotlet does not store your password and you need no AnyList API key. About the official AnyList API: AnyList has no public API, developer docs or official MCP server (checked 25 Oct 2026). The official connections are voice entry with Siri and Amazon Alexa, and an iCalendar link that shows your meal plan in a calendar app. Setup and FAQ: https://cotlet.dev/integrations/anylist-api-mcp-server
Search, save, organize, cook, and share recipes with any AI assistant.
AI-powered kitchen management — pantry, recipes, meal plans, shopping lists
Recipe search, ingredient matching, nutrition filters and a private cookbook for any AI agent.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Mealie for recipe management, meal planning, and shopping list operations. Supports searching and managing recipes, creating meal plans, and generating shopping lists from recipes or meal plans.7MIT
- FlicenseAqualityDmaintenanceEnables AI assistants to manage shopping lists and items (create, edit, delete, mark as purchased) via integration with a backend API.8-
- FlicenseNot gradedqualityBmaintenanceEnables 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.-
- AlicenseAqualityCmaintenanceEnables AI assistants to manage recipes, meal plans, and shopping lists in Mealie through natural language, supporting CRUD operations and URL-based recipe imports.27209 npm8MIT