Mcp Server
Connects Claude to MealMastery's full API for meal planning through natural language. You get 24 tools covering the complete workflow: generate AI meal plans with streaming progress, swap individual meals, manage recipes and favorites, create grocery lists, and send them directly to Kroger or Instacart for checkout. Three resources expose read-only context (current plan, preferences, grocery list), and four prompt templates guide common flows like weekly prep or quick dinner ideas. Uses short-lived JWT auth, respects tier-based rate limits, and follows the philosophy that MCP mirrors the core product rather than adding new capabilities. Useful when you want to plan meals conversationally instead of clicking through a UI.
- tools
- 24
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Mar 21, 2026
Tools
24 toolsPublic tool metadata for what this MCP can expose to an agent.
get_user_contextLoad full user profile, preferences, subscription, and latest plan
Load full user profile, preferences, subscription, and latest plan
No parameter schema in public metadata yet.
get_user_preferencesGet dietary preferences and cooking settings
Get dietary preferences and cooking settings
No parameter schema in public metadata yet.
update_user_preferencesUpdate dietary, allergy, or cuisine preferences
Update dietary, allergy, or cuisine preferences
No parameter schema in public metadata yet.
get_subscription_statusCheck subscription tier and usage limits
Check subscription tier and usage limits
No parameter schema in public metadata yet.
get_checkout_providersSee connected grocery providers (Instacart, Kroger)
See connected grocery providers (Instacart, Kroger)
No parameter schema in public metadata yet.
checkout_grocery_listSend a grocery list to Instacart or Kroger
Send a grocery list to Instacart or Kroger
No parameter schema in public metadata yet.
generate_meal_planGenerate a personalized meal plan using AI (with streaming progress)
Generate a personalized meal plan using AI (with streaming progress)
No parameter schema in public metadata yet.
get_latest_meal_planGet the current/most recent meal plan
Get the current/most recent meal plan
No parameter schema in public metadata yet.
get_meal_planGet a specific meal plan by ID
Get a specific meal plan by ID
No parameter schema in public metadata yet.
list_meal_plansBrowse meal plan history
Browse meal plan history
No parameter schema in public metadata yet.
regenerate_mealReplace one meal in a plan with a new AI-generated meal
Replace one meal in a plan with a new AI-generated meal
No parameter schema in public metadata yet.
generate_and_add_mealAdd a new AI meal to a plan at a specific slot
Add a new AI meal to a plan at a specific slot
No parameter schema in public metadata yet.
remove_mealRemove a meal from a plan
Remove a meal from a plan
No parameter schema in public metadata yet.
search_recipesSearch saved recipes
Search saved recipes
No parameter schema in public metadata yet.
get_recipeGet full recipe details
Get full recipe details
No parameter schema in public metadata yet.
save_meal_as_recipeSave a generated meal as a reusable recipe
Save a generated meal as a reusable recipe
No parameter schema in public metadata yet.
get_favorite_recipesGet list of favorited recipes
Get list of favorited recipes
No parameter schema in public metadata yet.
favorite_mealMark a meal as favorite
Mark a meal as favorite
No parameter schema in public metadata yet.
get_meal_ratingsGet ratings for meals in a plan
Get ratings for meals in a plan
No parameter schema in public metadata yet.
get_all_ratingsGet all-time recipe ratings
Get all-time recipe ratings
No parameter schema in public metadata yet.
generate_grocery_listCreate a grocery list from a meal plan
Create a grocery list from a meal plan
No parameter schema in public metadata yet.
get_grocery_listGet a specific grocery list
Get a specific grocery list
No parameter schema in public metadata yet.
list_grocery_listsBrowse grocery list history
Browse grocery list history
No parameter schema in public metadata yet.
update_grocery_itemsCheck off, exclude, or adjust grocery items
Check off, exclude, or adjust grocery items
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
MEALMASTERY_API_KEY*secretYour MealMastery developer API key (get one at mealmastery.ai/settings)
Readme
@mealmastery/mcp-server
MCP server for MealMastery AI meal planning. Integrates with Claude Desktop, VS Code Copilot, and other MCP-compatible AI agents.
Philosophy
The MCP server is a mirror of core capabilities, not a place where new features debut. Its value proposition is:
"Everything you can do in the app, you can now do through natural conversation in Claude."
The MCP layer adds convenience (natural language) and composability (chaining tools), but the underlying capabilities exist in the core product first. New features should be built as API endpoints powering the web/mobile apps, then exposed through MCP -- never the other way around.
Setup
- Get your API key from MealMastery Settings
- Add to your Claude Desktop config (
claude_desktop_config.json):
{
"mcpServers": {
"mealmastery": {
"command": "npx",
"args": ["-y", "@mealmastery/mcp-server"],
"env": {
"MEALMASTERY_API_KEY": "mm_live_..."
}
}
}
}
Features
24 Tools
Full CRUD for meal planning, recipes, grocery lists, and user preferences -- plus AI generation with streaming progress.
Details
- Repository
- github.com/mealmasteryai/mcp-server
- Package
@mealmastery/mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active