NYT Cooking MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on NYT Cooking: 35 typed functions through one MCP server. No NYT Cooking API key needed.
- Functions
- 35
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for NYT Cooking alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/nyt_cookingOne MCP server for NYT Cooking and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
clearGroceryListRemoves every recipe currently in the signed-in reader's grocery list, one at a time.Arguments
None.
Returns
NytCookingClearGroceryListResultinterface NytCookingClearGroceryListResult { cleared: true; removedCount: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/clearGroceryListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.clearGroceryList();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.clearGroceryList())curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/clearGroceryList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.clearGroceryList();getAccountProfileReads the signed-in reader's own account profile (display name, email).Arguments
None.
Returns
NytCookingAccountProfileinterface NytCookingAccountSubscription { name: string | null; status: string | null; // the site's own labels, read the values off a result, never guess one from prose active: boolean; entitlements: string[]; endDate: string | null; } interface NytCookingAccountProfile { userId: string; email: string | null; givenName: string | null; subscriptions: NytCookingAccountSubscription[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getAccountProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getAccountProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getAccountProfile())curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getAccountProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getAccountProfile();getArticleReads one cooking article or guide's title, summary, authors, full body text and any recipes it links to.Arguments
Name Type Required slugstringYes Returns
NytCookingArticleinterface NytCookingArticleRecipe { id: string; title: string; url: string; } interface NytCookingArticle { title: string; summary: string | null; authors: string[]; bodyText: string | null; publishedAt: string | null; relatedRecipes: NytCookingArticleRecipe[]; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getArticle({ slug: "how-to-make-a-grain-bowl" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getArticle({"slug": "how-to-make-a-grain-bowl"}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"how-to-make-a-grain-bowl"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getArticle({ slug: "how-to-make-a-grain-bowl" });getAuthorRecipesLists an author's published recipes off their byline page.Arguments
Name Type Required authorstringYes Returns
NytCookingAuthorRecipesinterface NytCookingAuthorRecipes { recipes: unknown[]; totalRecipes: number; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getAuthorRecipesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getAuthorRecipes({ author: "Mark Bittman" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getAuthorRecipes({"author": "Mark Bittman"}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getAuthorRecipes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"author":"Mark Bittman"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getAuthorRecipes({ author: "Mark Bittman" });getCollectionReads one curated editorial collection and the recipe cards inside it, off a collection url from searchRecipes.Arguments
Name Type Required urlstringYes Returns
NytCookingCollectioninterface NytCookingCollection { headline: string; summary: string | null; recipes: unknown[]; hasMore: boolean; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getCollectionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getCollection({ url: "/68861692-nyt-cooking/11265072-easy-weeknight-recipes-for-lazy-summer-evenings" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getCollection({ "url": "/68861692-nyt-cooking/11265072-easy-weeknight-recipes-for-lazy-summer-evenings" }))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getCollection \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"/68861692-nyt-cooking/11265072-easy-weeknight-recipes-for-lazy-summer-evenings"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getCollection({ url: "/68861692-nyt-cooking/11265072-easy-weeknight-recipes-for-lazy-summer-evenings" });getCookedRecipesLists the recipes the signed-in reader has marked cooked.Arguments
None.
Returns
NytCookingGetCookedRecipesResultinterface NytCookingGetCookedRecipesResult { recipes: unknown[]; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getCookedRecipesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getCookedRecipes();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getCookedRecipes())curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getCookedRecipes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getCookedRecipes();getGroceryListReads the signed-in reader's own grocery list.Arguments
None.
Returns
NytCookingGetGroceryListResultinterface NytCookingGetGroceryListResult { lists: unknown[]; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getGroceryListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getGroceryList();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getGroceryList())curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getGroceryList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getGroceryList();getMyNotesReads the signed-in reader's own private cook notes on a recipe.Arguments
Name Type Required recipeIdnumber | stringYes Returns
NytCookingGetMyNotesResultinterface NytCookingPrivateNote { id: string; text: string; createdAt: string | null; } interface NytCookingGetMyNotesResult { recipeId: number; notes: NytCookingPrivateNote[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getMyNotesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getMyNotes({ recipeId: 12965 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getMyNotes({"recipeId": 12965}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getMyNotes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"recipeId":12965}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getMyNotes({ recipeId: 12965 });getMyRatingReads the signed-in reader's own rating for a recipe.Arguments
Name Type Required recipeIdnumber | stringYes Returns
NytCookingGetMyRatingResultinterface NytCookingGetMyRatingResult { recipeId: number; rating: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getMyRatingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getMyRating({ recipeId: 12965 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getMyRating({"recipeId": 12965}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getMyRating \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"recipeId":12965}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getMyRating({ recipeId: 12965 });getRecipeReads one recipe's full detail.Arguments
Name Type Required idnumber | stringYes Returns
NytCookingRecipeinterface NytCookingRecipe { id: number; title: string; url: string; yieldText: string | null; prepTime: string | null; cookTime: string | null; totalTime: string | null; rating: { average: number; count: number } | null; authors: string[]; ingredients: string[]; steps: string[]; tags: string[]; description: string | null; // the headnote, flattened to text nutrition: { caloriesPerServing: number | null; nutrients: Array<{ label: string; code: string; quantity: number; unit: string }> } | null; tips: string[]; imageUrl: string | null; // hero photo's largest rendition }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getRecipeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getRecipe({ id: "/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getRecipe({ "id": "/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon" }))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getRecipe \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getRecipe({ id: "/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon" });getRecipeNotesReads a recipe's reader notes.Arguments
Name Type Required idnumber | stringYes sort"helpful" | "recent"No Returns
NytCookingRecipeNotesinterface NytCookingRecipeNote { id: string; author: string; text: string; submittedAt: string; recommendedCount: number; } interface NytCookingRecipeNotes { notes: NytCookingRecipeNote[]; totalNotes: number; totalHelpful: number; hasMore: boolean; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getRecipeNotesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getRecipeNotes({ id: "/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getRecipeNotes({ "id": "/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon" }))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getRecipeNotes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getRecipeNotes({ id: "/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon" });getRelatedRecipesReads a recipe's own "More like this" carousels (e.g. "Trending On Cooking") off its page, each with a title and its recipe rows.Arguments
Name Type Required idnumber | stringYes Returns
NytCookingRelatedRecipesinterface NytCookingRelatedRecipe { id: string; title: string; url: string; rating: { average: number; count: number } | null; totalTimeDisplay: string | null; } interface NytCookingRelatedRecipeCarousel { title: string; recipes: NytCookingRelatedRecipe[]; } interface NytCookingRelatedRecipes { carousels: NytCookingRelatedRecipeCarousel[]; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getRelatedRecipesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getRelatedRecipes({ id: "/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getRelatedRecipes({ "id": "/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon" }))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getRelatedRecipes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getRelatedRecipes({ id: "/recipes/1025436-one-pot-chicken-and-rice-with-caramelized-lemon" });getSavedRecipesLists the signed-in reader's saved recipes (their Recipe Box).Arguments
Name Type Required limitnumberNo afterstringNo Returns
NytCookingSavedRecipesResultinterface NytCookingSavedRecipe { id: number | null; title: string; url: string; byline: string | null; totalTime: string | null; rating: number | null; ratingCount: number | null; imageUrl: string | null; } interface NytCookingSavedRecipesResult { totalCount: number; recipes: NytCookingSavedRecipe[]; nextCursor: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getSavedRecipesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getSavedRecipes({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getSavedRecipes({}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getSavedRecipes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getSavedRecipes({});getSeasonalGuideReads a seasonal guide page (e.g. "/thanksgiving", "/christmas") and its featured recipes.Arguments
Name Type Required slugstringYes Returns
NytCookingSeasonalGuideinterface NytCookingSeasonalGuideCollection { id: string; name: string; url: string; } interface NytCookingSeasonalGuide { slug: string; title: string; summary: string | null; recipes: unknown[]; totalRecipes: number; collections: NytCookingSeasonalGuideCollection[]; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getSeasonalGuideCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getSeasonalGuide({ slug: "thanksgiving" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getSeasonalGuide({"slug": "thanksgiving"}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getSeasonalGuide \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"thanksgiving"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getSeasonalGuide({ slug: "thanksgiving" });getTopicReads one topic page (e.g. "dinner-recipes", "vegan-recipes") and its tagged recipes.Arguments
Name Type Required slugstringYes Returns
NytCookingTopicinterface NytCookingTopic { slug: string; title: string; recipes: unknown[]; totalRecipes: number; page: number; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getTopicCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getTopic({ slug: "dinner-recipes" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getTopic({"slug": "dinner-recipes"}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getTopic \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"dinner-recipes"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getTopic({ slug: "dinner-recipes" });getTrendingArticlesLists the articles behind the site's "Most Popular This Week" homepage carousel.Arguments
None.
Returns
NytCookingTrendingArticlesinterface NytCookingTrendingArticle { title: string; url: string; summary: string | null; } interface NytCookingTrendingArticles { articles: NytCookingTrendingArticle[]; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/getTrendingArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.getTrendingArticles();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.getTrendingArticles())curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/getTrendingArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.getTrendingArticles();listFeaturedCollectionsLists the collections currently featured on the site's own homepage.Arguments
None.
Returns
NytCookingFeaturedCollectionsinterface NytCookingFeaturedCollection { id: number; name: string; url: string; totalCollectionSize: number; } interface NytCookingFeaturedCollections { collections: NytCookingFeaturedCollection[]; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/listFeaturedCollectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.listFeaturedCollections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.listFeaturedCollections())curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/listFeaturedCollections \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.listFeaturedCollections();listRecipeBoxFoldersLists the signed-in reader's own Recipe Box folders.Arguments
None.
Returns
NytCookingListRecipeBoxFoldersResultinterface NytCookingRecipeBoxFolder { id: string; slug: string; name: string; description: string | null; url: string; uri: string; collectableCount: number; folderRecipeIds: number[]; } interface NytCookingListRecipeBoxFoldersResult { folders: NytCookingRecipeBoxFolder[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/listRecipeBoxFoldersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.listRecipeBoxFolders();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.listRecipeBoxFolders())curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/listRecipeBoxFolders \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.listRecipeBoxFolders();listTopicsLists the site's topic pages off its own navigation.Arguments
None.
Returns
NytCookingTopicsListinterface NytCookingTopicItem { slug: string; title: string; } interface NytCookingTopicsList { topics: NytCookingTopicItem[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/listTopicsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.listTopics();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.listTopics())curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/listTopics \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.listTopics();rateRecipeSubmits the signed-in reader's own rating for a recipe, on NYT Cooking's own 1-4 scale.Arguments
Name Type Required recipeIdnumber | stringYes ratingnumberYes Returns
NytCookingRateRecipeResultinterface NytCookingRateRecipeResult { recipeId: number; rating: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/rateRecipeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.rateRecipe({ recipeId: 12965, rating: 4 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.rateRecipe({"recipeId": 12965, "rating": 4}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/rateRecipe \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"recipeId":12965,"rating":4}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.rateRecipe({ recipeId: 12965, rating: 4 });searchMyRecipeBoxSearches inside the signed-in reader's own saved Recipe Box, rather than the whole site.Arguments
Name Type Required querystringYes limitnumberNo afterstringNo Returns
NytCookingSavedRecipesResultinterface NytCookingSavedRecipe { id: number | null; title: string; url: string; byline: string | null; totalTime: string | null; rating: number | null; ratingCount: number | null; imageUrl: string | null; } interface NytCookingSavedRecipesResult { totalCount: number; recipes: NytCookingSavedRecipe[]; nextCursor: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/searchMyRecipeBoxCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.searchMyRecipeBox({ query: "chicken" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.searchMyRecipeBox({"query": "chicken"}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/searchMyRecipeBox \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"chicken"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.searchMyRecipeBox({ query: "chicken" });searchRecipesRuns the site's own recipe search (query text plus cuisine/diet/mealType/cookTime filters) and returns recipe and collection rows.Arguments
Name Type Required querystringYes cuisinestringNo mealTypestringNo authorstringNo Returns
NytCookingSearchResultinterface NytCookingSearchResult { results: unknown[]; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/searchRecipesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.searchRecipes({ query: "pasta" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.searchRecipes({"query": "pasta"}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/searchRecipes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"pasta"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.searchRecipes({ query: "pasta" });unsaveRecipeRemoves a recipe from the signed-in reader's Recipe Box.Arguments
Name Type Required recipeIdnumber | stringYes Returns
NytCookingUnsaveRecipeResultinterface NytCookingUnsaveRecipeResult { recipeId: number; saved: false; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/unsaveRecipeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.unsaveRecipe({ recipeId: 12965 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.unsaveRecipe({"recipeId": 12965}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/unsaveRecipe \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"recipeId":12965}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.unsaveRecipe({ recipeId: 12965 });
addRecipeToFolderFiles a saved recipe into one of the signed-in reader's Recipe Box folders.Arguments
Name Type Required folderIdnumber | stringThe folder's id, listRecipeBoxFolders' own id field.Yes recipeIdnumber | stringThe recipe's numeric id, getRecipe's own id field, or a searchRecipes/getTopic/getCollection/getSeasonalGuide/getRelatedRecipes row's id.Yes Returns
NytCookingAddRecipeToFolderResultinterface NytCookingAddRecipeToFolderResult { folderId: string; recipeId: number; filed: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/addRecipeToFolderCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.addRecipeToFolder({ folderId: 1, recipeId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.addRecipeToFolder({"folderId": 1, "recipeId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/addRecipeToFolder \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"folderId":1,"recipeId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.addRecipeToFolder({ folderId: 1, recipeId: 1 });addToGroceryListAdds a recipe's ingredients to the signed-in reader's grocery list.Arguments
Name Type Required recipeIdnumber | stringYes Returns
NytCookingAddToGroceryListResultinterface NytCookingAddToGroceryListResult { recipeId: number; added: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/addToGroceryListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.addToGroceryList({ recipeId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.addToGroceryList({"recipeId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/addToGroceryList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"recipeId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.addToGroceryList({ recipeId: 1 });createRecipeBoxFolderCreates a new Recipe Box folder for the signed-in reader.Arguments
Name Type Required folderNamestringYes recipeIdnumber | stringNo Returns
NytCookingCreateRecipeBoxFolderResultinterface NytCookingCreateRecipeBoxFolderResult { folder: { id: string; name: string; recipesCount: number }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/createRecipeBoxFolderCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.createRecipeBoxFolder({ folderName: "<folderName>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.createRecipeBoxFolder({"folderName": "<folderName>"}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/createRecipeBoxFolder \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"folderName":"<folderName>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.createRecipeBoxFolder({ folderName: "<folderName>" });createRecipeNoteWrites the signed-in reader's own private cook note on a recipe.Arguments
Name Type Required recipeIdnumber | stringYes textstringYes Returns
NytCookingCreateRecipeNoteResultinterface NytCookingPrivateNote { id: string; text: string; createdAt: string | null; } interface NytCookingCreateRecipeNoteResult { recipeId: number; note: NytCookingPrivateNote; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/createRecipeNoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.createRecipeNote({ recipeId: 1, text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.createRecipeNote({"recipeId": 1, "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/createRecipeNote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"recipeId":1,"text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.createRecipeNote({ recipeId: 1, text: "<text>" });deleteRecipeBoxFolderDeletes one of the signed-in reader's Recipe Box folders.Arguments
Name Type Required folderIdnumber | stringYes Returns
NytCookingDeleteRecipeBoxFolderResultinterface NytCookingDeleteRecipeBoxFolderResult { folderId: string; deleted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/deleteRecipeBoxFolderCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.deleteRecipeBoxFolder({ folderId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.deleteRecipeBoxFolder({"folderId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/deleteRecipeBoxFolder \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"folderId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.deleteRecipeBoxFolder({ folderId: 1 });deleteRecipeNoteDeletes one of the signed-in reader's own private cook notes.Arguments
Name Type Required recipeIdnumber | stringYes noteIdstringYes Returns
NytCookingDeleteRecipeNoteResultinterface NytCookingPrivateNote { id: string; text: string; createdAt: string | null; } interface NytCookingDeleteRecipeNoteResult { recipeId: number; noteId: string; deleted: true; notes: NytCookingPrivateNote[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/deleteRecipeNoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.deleteRecipeNote({ recipeId: 1, noteId: "<noteId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.deleteRecipeNote({"recipeId": 1, "noteId": "<noteId>"}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/deleteRecipeNote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"recipeId":1,"noteId":"<noteId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.deleteRecipeNote({ recipeId: 1, noteId: "<noteId>" });markRecipeCookedMarks a recipe as cooked on the signed-in reader's account.Arguments
Name Type Required recipeIdnumber | stringYes Returns
NytCookingMarkRecipeCookedResultinterface NytCookingMarkRecipeCookedResult { recipeId: number; marked: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/markRecipeCookedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.markRecipeCooked({ recipeId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.markRecipeCooked({"recipeId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/markRecipeCooked \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"recipeId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.markRecipeCooked({ recipeId: 1 });removeFromGroceryListRemoves a recipe's ingredients from the signed-in reader's grocery list.Arguments
Name Type Required recipeIdnumber | stringYes Returns
NytCookingRemoveFromGroceryListResultinterface NytCookingRemoveFromGroceryListResult { recipeId: number; removed: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/removeFromGroceryListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.removeFromGroceryList({ recipeId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.removeFromGroceryList({"recipeId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/removeFromGroceryList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"recipeId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.removeFromGroceryList({ recipeId: 1 });removeRecipeFromFolderRemoves a saved recipe from one of the signed-in reader's Recipe Box folders.Arguments
Name Type Required folderIdnumber | stringThe folder's id, listRecipeBoxFolders' own id field.Yes recipeIdnumber | stringThe recipe's numeric id, getRecipe's own id field, or a searchRecipes/getTopic/getCollection/getSeasonalGuide/getRelatedRecipes row's id.Yes Returns
NytCookingRemoveRecipeFromFolderResultinterface NytCookingRemoveRecipeFromFolderResult { folderId: string; recipeId: number; removed: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/removeRecipeFromFolderCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.removeRecipeFromFolder({ folderId: 1, recipeId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.removeRecipeFromFolder({"folderId": 1, "recipeId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/removeRecipeFromFolder \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"folderId":1,"recipeId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.removeRecipeFromFolder({ folderId: 1, recipeId: 1 });renameRecipeBoxFolderRenames one of the signed-in reader's Recipe Box folders.Arguments
Name Type Required folderIdnumber | stringYes folderNamestringYes descriptionstringNo Returns
NytCookingRenameRecipeBoxFolderResultinterface NytCookingRenameRecipeBoxFolderResult { folderId: string; renamed: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/renameRecipeBoxFolderCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.renameRecipeBoxFolder({ folderId: 1, folderName: "<folderName>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.renameRecipeBoxFolder({"folderId": 1, "folderName": "<folderName>"}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/renameRecipeBoxFolder \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"folderId":1,"folderName":"<folderName>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.renameRecipeBoxFolder({ folderId: 1, folderName: "<folderName>" });saveRecipeSaves a recipe to the signed-in reader's Recipe Box.Arguments
Name Type Required recipeIdnumber | stringYes Returns
NytCookingSaveRecipeResultinterface NytCookingSaveRecipeResult { recipeId: number; saved: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/saveRecipeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.saveRecipe({ recipeId: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.saveRecipe({"recipeId": 1}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/saveRecipe \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"recipeId":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.saveRecipe({ recipeId: 1 });updateRecipeNoteEdits one of the signed-in reader's own private cook notes.Arguments
Name Type Required recipeIdnumber | stringYes noteIdstringYes textstringYes Returns
NytCookingUpdateRecipeNoteResultinterface NytCookingPrivateNote { id: string; text: string; createdAt: string | null; } interface NytCookingUpdateRecipeNoteResult { recipeId: number; notes: NytCookingPrivateNote[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/nyt_cooking/updateRecipeNoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.nyt_cooking.updateRecipeNote({ recipeId: 1, noteId: "<noteId>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.nyt_cooking.updateRecipeNote({"recipeId": 1, "noteId": "<noteId>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/nyt_cooking/updateRecipeNote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"recipeId":1,"noteId":"<noteId>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.nyt_cooking.updateRecipeNote({ recipeId: 1, noteId: "<noteId>", text: "<text>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/nyt_cooking/<function> - OpenAPI
/v1/sites/nyt_cooking/openapi.json