Skip to main content
Glama
AnyList MCP Server

AnyList MCP Server

by davidashman

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

  1. Clone this repository:

    git clone <this-repo> anylist-mcp
    cd anylist-mcp
  2. Install dependencies:

    npm install
  3. Build:

    npm run build

Configuration

The server requires your AnyList credentials as environment variables:

Variable

Description

ANYLIST_EMAIL

Your AnyList account email

ANYLIST_PASSWORD

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

Or for development:

ANYLIST_EMAIL=you@example.com ANYLIST_PASSWORD=secret npm run dev

Tools

Lists

Tool

Description

get_lists

List all shopping lists with item counts

get_list_items

Get all items on a specific list

add_item_to_list

Add a freeform item to a list (with duplicate checking)

add_ingredient_to_list

Add a recipe ingredient to a list with proper categorization

Recipes

Tool

Description

get_recipes

List all recipes, optionally filtered by name

get_recipe_details

Get full recipe details including ingredients and steps

Groceries

Tool

Description

add_recipe_ingredients_to_list

Add all ingredients from a recipe to a list

add_ingredients_to_list

Batch add ingredients from multiple recipes to a list

Meal Planning

Tool

Description

get_meal_plan

Get meal plan events for a date range (defaults to current week)

add_meal_plan_event

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 item

  • list_name (required) — Target list name

  • quantity (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_name or recipe_id (one required) — The recipe to pull from

  • ingredient_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_name or recipe_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_names or recipe_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_name or recipe_id (one required)

add_meal_plan_event

Schedule a recipe or titled event on the meal plan calendar.

  • date (required) — YYYY-MM-DD format

  • recipe_name or recipe_id (optional) — Recipe to schedule

  • title (optional) — Event title (used if no recipe, or as override)

  • label (optional) — e.g. "Breakfast", "Lunch", "Dinner"

License

ISC

Available Tools

10 tools
add_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

    A3.7/5.0

    Scored across 10 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      7
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to manage shopping lists and items (create, edit, delete, mark as purchased) via integration with a backend API.
      8
      -
    • F
      license
      Not graded
      quality
      B
      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.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to manage recipes, meal plans, and shopping lists in Mealie through natural language, supporting CRUD operations and URL-based recipe imports.
      27
      209 npm
      8
      MIT