24 actions ready for your AI

Connect Spoonacular to your AI

Add your Spoonacular key once and every AI you use can search foods, search autocomplete recipes and search recipes through it.

Needs your API keyWorks today: paste the key from this app and your AI can use it. One-click sign-in is not built yet.

Not verified by us yet. Its actions come from Spoonacular's own documented API, and we have not run them here yet.

Use your own Spoonacular account. Credentials stay encrypted in ahel.

Tell me when ahel has verified Spoonacular

What your AI can do with Spoonacular

Choose a task and ask your AI.

Recipe

  • Search recipesGET

    Search Recipes

    query
    The (natural language) search query.
    cuisine
    The cuisine(s) of the recipes.
    excludeCuisine
    The cuisine(s) the recipes must not match.
    diet
    The diet for which the recipes must be suitable.
  • Search recipes by ingredientsGET

    Search Recipes by Ingredients

    ingredients
    A comma-separated list of ingredients that the recipes should contain.
    number
    The maximum number of items to return (between 1 and 100).
    limitLicense
    Whether the recipes should have an open license that allows display with proper attribution.
    ranking
    Whether to maximize used ingredients (1) or minimize missing ingredients (2) first.
  • Search recipes by nutrientsGET

    Search Recipes by Nutrients

    minCarbs
    The minimum amount of carbohydrates in grams the recipe must have.
    maxCarbs
    The maximum amount of carbohydrates in grams the recipe can have.
    minProtein
    The minimum amount of protein in grams the recipe must have.
    maxProtein
    The maximum amount of protein in grams the recipe can have.
  • Get recipe information bulkGET

    Get Recipe Information Bulk

    idsrequired
    A comma-separated list of recipe ids.
    includeNutrition
    Include nutrition data in the recipe information.
  • Create recipe cardPOST

    Create Recipe Card

    bodyrequired
    The request body.
    Content-Type
    The content type.
  • Create recipe card getGET

    Create Recipe Card

    idrequired
    The recipe id.
    mask
    The mask to put over the recipe image ("ellipseMask", "diamondMask", "starMask", "heartMask", "potMask", "fishMask").
    backgroundImage
    The background image ("none","background1", or "background2").
    backgroundColor
    The background color for the recipe card as a hex-string.

Autocomplete

  • Autocomplete recipe searchGET

    Autocomplete Recipe Search

    query
    The (natural language) search query.
    number
    The maximum number of items to return (between 1 and 100).
  • Autocomplete ingredient searchGET

    Autocomplete Ingredient Search

    query
    The (natural language) search query.
    number
    The maximum number of items to return (between 1 and 100).
    metaInformation
    Whether to return more meta information about the ingredients.
    intolerances
    A comma-separated list of intolerances.
  • Autocomplete menu item searchGET

    Autocomplete Menu Item Search

    queryrequired
    The (partial) search query.
    number
    The number of results to return (between 1 and 25).
  • Autocomplete product searchGET

    Autocomplete Product Search

    queryrequired
    The (partial) search query.
    number
    The number of results to return (between 1 and 25).

Food

  • Search all foodGET

    Search All Food

    queryrequired
    The search query.
    offset
    The number of results to skip (between 0 and 900).
    number
    The maximum number of items to return (between 1 and 100).
  • Search food videosGET

    Search Food Videos

    query
    The (natural language) search query.
    type
    The type of the recipes.
    cuisine
    The cuisine(s) of the recipes.
    diet
    The diet for which the recipes must be suitable.

Ingredient

  • Ingredient searchGET

    Ingredient Search

    query
    The (natural language) search query.
    addChildren
    Whether to add children of found foods.
    minProteinPercent
    The minimum percentage of protein the food must have (between 0 and 100).
    maxProteinPercent
    The maximum percentage of protein the food can have (between 0 and 100).
  • Get ingredient substitutesGET

    Get Ingredient Substitutes

    ingredientNamerequired
    The name of the ingredient you want to replace.
Show 9 more groups

Menu

  • Search menu itemsGET

    Search Menu Items

    query
    The (natural language) search query.
    minCalories
    The minimum amount of calories the menu item must have.
    maxCalories
    The maximum amount of calories the menu item can have.
    minCarbs
    The minimum amount of carbohydrates in grams the menu item must have.
  • Get menu item informationGET

    Get Menu Item Information

    idrequired
    The menu item id.

Analyze

  • Analyze arecipe search queryGET

    Analyze a Recipe Search Query

    qrequired
    The recipe search query.

Analyzed

  • Get analyzed recipe instructionsGET

    Get Analyzed Recipe Instructions

    idrequired
    The recipe id.
    stepBreakdown
    Whether to break down the recipe steps even more.

Custom

  • Search custom foodsGET

    Search Custom Foods

    usernamerequired
    The username.
    hashrequired
    The private hash for the username.
    query
    The (natural language) search query.
    offset
    The number of results to skip (between 0 and 900).

Grocery

  • Search grocery productsGET

    Search Grocery Products

    query
    The (natural language) search query.
    minCalories
    The minimum amount of calories the product must have.
    maxCalories
    The maximum amount of calories the product can have.
    minCarbs
    The minimum amount of carbohydrates in grams the product must have.

Product

  • Get product informationGET

    Get Product Information

    idrequired
    The id of the packaged food.

Random

  • Get random recipesGET

    Get Random Recipes

    limitLicense
    Whether the recipes should have an open license that allows display with proper attribution.
    tags
    The tags (can be diets, meal types, cuisines, or intolerances) that the recipe must have.
    number
    The maximum number of items to return (between 1 and 100).

Restaurant

  • Search restaurantsGET

    Search Restaurants

    query
    The search query.
    lat
    The latitude of the user's location.
    lng
    The longitude of the user's location.".
    distance
    The distance around the location in miles.

Site

  • Search site contentGET

    Search Site Content

    queryrequired
    The query to search for.

Ask your AI

Try one of these requests with a connected AI.

  • Find foods in Spoonacular
  • Find autocomplete recipes in Spoonacular
  • Find recipes in Spoonacular
  • Find recipe ingredients in Spoonacular
  • Find recipe nutrients in Spoonacular
  • Show me the recipe information in Spoonacular

Published servers for Spoonacular

Built by the community and served through your gateway with the same key. A curated pick is one ahel has checked.

Spoonacular MCP server, hosted by ahel

One hosted endpoint serves Spoonacular. There is nothing to install and no local server to run.

Connect Spoonacular to Claude, Claude Code, Cursor or Codex

  1. Add your Spoonacular key. ahel stores it encrypted.
  2. Paste one link into your AI: https://mcp.ahel.ai (once, for every app).
  3. Ask for the work. Your AI picks the action and ahel runs it with your key.

Documentation

About Spoonacular

Spoonacular is a developer tools service. Connect your own key and your AI can search foods, search autocomplete recipes and search recipes.

Spoonacular over MCP: ahel serves Spoonacular to Claude, Claude Code, Cursor and Codex as one hosted MCP endpoint. There is no local server to run. Add your Spoonacular key once, paste one link into your AI, and the actions above are there.

Developer tools

Questions

Is my Spoonacular key safe?

Your Spoonacular key is sealed in ahel and added to the request server-side when your AI calls Spoonacular. It never crosses the MCP link, no tool can read it back, and you can turn the app off or remove the key at any time.

Which AIs can use Spoonacular through ahel?

Any MCP-capable AI: Claude, Claude Code, Codex, Cursor, VS Code and others. Paste one link, https://mcp.ahel.ai, into the AI once and everything in your gateway arrives through it.

What can my AI do with Spoonacular?

24 actions today, covering recipes, autocompletes and foods. Ask in plain language; your AI picks the action and ahel runs it with your key.

Does connecting Spoonacular cost anything?

Connecting apps is free during ahel's early access. Free, Pro and Team all cost nothing today, and the pricing page lists what each one includes. Spoonacular may bill you for API use under its own terms.