Schema | mealie-mcp

mealie-mcp

Overview Schema Related Servers Score Discussions

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`MEALIE_TOKEN`	No	Alias for MEALIE_API_TOKEN.
`MEALIE_TOOLS`	No	Comma-separated allow-list of tool names or category prefixes to expose. Empty = all.
`MEALIE_TIMEOUT`	No	Per-request timeout in milliseconds.	60000
`MEALIE_BASE_URL`	Yes	Base URL of your Mealie instance, e.g. https://mealie.example.com
`MEALIE_API_TOKEN`	No	Long-lived Mealie API token (sent as Authorization: Bearer). Most endpoints need it. MEALIE_TOKEN is accepted as an alias.
`MEALIE_READ_ONLY`	No	When true, only expose GET endpoints.	false
`MEALIE_OPENAPI_URL`	No	Override where the OpenAPI schema is fetched from.
`MEALIE_EXCLUDE_TOOLS`	No	Comma-separated deny-list of tool names or category prefixes to hide.
`MEALIE_TOOL_NAME_MAX`	No	Max length of generated tool names (clamped to 16–64).	50
`MEALIE_ACCEPT_LANGUAGE`	No	Optional Accept-Language header forwarded to Mealie.
`MEALIE_USE_BUNDLED_SPEC`	No	Skip the live OpenAPI fetch and use the snapshot bundled with the package.	false

Capabilities

Features and capabilities supported by this server

Capability	Details
`tools`	{}

Tools

Functions exposed to the LLM to take actions

Name	Description
app_about_get_app_infoB	Get App Info [GET /api/app/about] Get general application information
get_startup_infoC	Get Startup Info [GET /api/app/about/startup-info] returns helpful startup information
get_app_themeC	Get App Theme [GET /api/app/about/theme] Get's the current theme settings
get_tokenD	Get Token [POST /api/auth/token]
oauth_loginD	Oauth Login [GET /api/auth/oauth]
oauth_callbackC	Oauth Callback [GET /api/auth/oauth/callback]
refresh_tokenA	Refresh Token [GET /api/auth/refresh] Use a valid token to get another token
logoutC	Logout [POST /api/auth/logout]
get_logged_in_userC	Get Logged In User [GET /api/users/self]
get_logged_in_user_ratingsB	Get Logged In User Ratings [GET /api/users/self/ratings]
get_logged_in_user_rating_for_recipeD	Get Logged In User Rating For Recipe [GET /api/users/self/ratings/{recipe_id}]
get_logged_in_user_favoritesB	Get Logged In User Favorites [GET /api/users/self/favorites]
update_passwordC	Update Password [PUT /api/users/password] Resets the User Password
update_userD	Update User [PUT /api/users/{item_id}]
update_user_imageC	Update User Image [POST /api/users/{id}/image] Updates a User Image
create_api_tokenC	Create Api Token [POST /api/users/api-tokens] Create api_token in the Database
delete_api_tokenC	Delete Api Token [DELETE /api/users/api-tokens/{token_id}] Delete api_token from the Database
get_ratingsC	Get Ratings [GET /api/users/{id}/ratings] Get user's rated recipes
get_favoritesC	Get Favorites [GET /api/users/{id}/favorites] Get user's favorited recipes
set_ratingC	Set Rating [POST /api/users/{id}/ratings/{slug}] Sets the user's rating for a recipe
add_favoriteC	Add Favorite [POST /api/users/{id}/favorites/{slug}] Adds a recipe to the user's favorites
remove_favoriteA	Remove Favorite [DELETE /api/users/{id}/favorites/{slug}] Removes a recipe from the user's favorites
households_cookbooks_get_allD	Get All [GET /api/households/cookbooks]
households_cookbooks_create_oneD	Create One [POST /api/households/cookbooks]
households_cookbooks_update_manyC	Update Many [PUT /api/households/cookbooks]
households_cookbooks_get_oneD	Get One [GET /api/households/cookbooks/{item_id}]
households_cookbooks_update_oneD	Update One [PUT /api/households/cookbooks/{item_id}]
households_cookbooks_delete_oneC	Delete One [DELETE /api/households/cookbooks/{item_id}]
households_event_notifications_get_allC	Get All [GET /api/households/events/notifications]
households_event_notifications_create_oneD	Create One [POST /api/households/events/notifications]
households_event_notifications_get_oneD	Get One [GET /api/households/events/notifications/{item_id}]
households_event_notifications_update_oneD	Update One [PUT /api/households/events/notifications/{item_id}]
households_event_notifications_delete_oneD	Delete One [DELETE /api/households/events/notifications/{item_id}]
test_notificationD	Test Notification [POST /api/households/events/notifications/{item_id}/test]
households_recipe_actions_get_allD	Get All [GET /api/households/recipe-actions]
households_recipe_actions_create_oneD	Create One [POST /api/households/recipe-actions]
households_recipe_actions_get_oneD	Get One [GET /api/households/recipe-actions/{item_id}]
households_recipe_actions_update_oneD	Update One [PUT /api/households/recipe-actions/{item_id}]
households_recipe_actions_delete_oneC	Delete One [DELETE /api/households/recipe-actions/{item_id}]
trigger_actionD	Trigger Action [POST /api/households/recipe-actions/{item_id}/trigger/{recipe_slug}]
get_logged_in_user_householdB	Get Logged In User Household [GET /api/households/self] Returns the Household Data for the Current User
get_household_recipeC	Get Household Recipe [GET /api/households/self/recipes/{recipe_slug}] Returns recipe data for the current household
get_household_membersC	Get Household Members [GET /api/households/members] Returns all users belonging to the current household
get_household_preferencesB	Get Household Preferences [GET /api/households/preferences]
update_household_preferencesC	Update Household Preferences [PUT /api/households/preferences]
set_member_permissionsD	Set Member Permissions [PUT /api/households/permissions]
get_statisticsC	Get Statistics [GET /api/households/statistics]
get_invite_tokensB	Get Invite Tokens [GET /api/households/invitations]
create_invite_tokenC	Create Invite Token [POST /api/households/invitations]
email_invitationD	Email Invitation [POST /api/households/invitations/email]
households_shopping_lists_get_allD	Get All [GET /api/households/shopping/lists]
households_shopping_lists_create_oneD	Create One [POST /api/households/shopping/lists]
households_shopping_lists_get_oneC	Get One [GET /api/households/shopping/lists/{item_id}]
households_shopping_lists_update_oneD	Update One [PUT /api/households/shopping/lists/{item_id}]
households_shopping_lists_delete_oneD	Delete One [DELETE /api/households/shopping/lists/{item_id}]
update_label_settingsC	Update Label Settings [PUT /api/households/shopping/lists/{item_id}/label-settings]
add_recipe_ingredients_to_listC	Add Recipe Ingredients To List [POST /api/households/shopping/lists/{item_id}/recipe]
add_single_recipe_ingredients_to_listC	(DEPRECATED) Add Single Recipe Ingredients To List [POST /api/households/shopping/lists/{item_id}/recipe/{recipe_id}]
remove_recipe_ingredients_from_listC	Remove Recipe Ingredients From List [POST /api/households/shopping/lists/{item_id}/recipe/{recipe_id}/delete]
households_shopping_list_items_get_allD	Get All [GET /api/households/shopping/items]
households_shopping_list_items_create_oneC	Create One [POST /api/households/shopping/items]
households_shopping_list_items_update_manyD	Update Many [PUT /api/households/shopping/items]
delete_manyC	Delete Many [DELETE /api/households/shopping/items]
create_manyD	Create Many [POST /api/households/shopping/items/create-bulk]
households_shopping_list_items_get_oneD	Get One [GET /api/households/shopping/items/{item_id}]
households_shopping_list_items_update_oneD	Update One [PUT /api/households/shopping/items/{item_id}]
households_shopping_list_items_delete_oneC	Delete One [DELETE /api/households/shopping/items/{item_id}]
households_webhooks_get_allC	Get All [GET /api/households/webhooks]
households_webhooks_create_oneD	Create One [POST /api/households/webhooks]
rerun_webhooksB	Rerun Webhooks [POST /api/households/webhooks/rerun] Manually re-fires all previously scheduled webhooks for today
households_webhooks_get_oneD	Get One [GET /api/households/webhooks/{item_id}]
households_webhooks_update_oneD	Update One [PUT /api/households/webhooks/{item_id}]
households_webhooks_delete_oneC	Delete One [DELETE /api/households/webhooks/{item_id}]
test_oneD	Test One [POST /api/households/webhooks/{item_id}/test]
households_mealplan_rules_get_allD	Get All [GET /api/households/mealplans/rules]
households_mealplan_rules_create_oneD	Create One [POST /api/households/mealplans/rules]
households_mealplan_rules_get_oneD	Get One [GET /api/households/mealplans/rules/{item_id}]
households_mealplan_rules_update_oneD	Update One [PUT /api/households/mealplans/rules/{item_id}]
households_mealplan_rules_delete_oneC	Delete One [DELETE /api/households/mealplans/rules/{item_id}]
households_mealplans_get_allD	Get All [GET /api/households/mealplans]
households_mealplans_create_oneD	Create One [POST /api/households/mealplans]
get_todays_mealsC	Get Todays Meals [GET /api/households/mealplans/today]
create_random_mealC	Create Random Meal [POST /api/households/mealplans/random] `create_random_meal` is a route that provides the randomized functionality for mealplaners. It operates by following the rules set out in the household's mealplan settings. If no settings are set, it will return any random meal. Refer to the mealplan settings routes for more information on how rules can be applied to the random meal selector.
households_mealplans_get_oneC	Get One [GET /api/households/mealplans/{item_id}]
households_mealplans_update_oneC	Update One [PUT /api/households/mealplans/{item_id}]
households_mealplans_delete_oneC	Delete One [DELETE /api/households/mealplans/{item_id}]
groups_ai_providers_create_ai_providerC	Create Ai Provider [POST /api/groups/ai-providers/providers]
groups_ai_providers_get_ai_providerC	Get Ai Provider [GET /api/groups/ai-providers/providers/{provider_id}]
groups_ai_providers_update_ai_providerC	Update Ai Provider [PUT /api/groups/ai-providers/providers/{provider_id}]
groups_ai_providers_delete_ai_providerC	Delete Ai Provider [DELETE /api/groups/ai-providers/providers/{provider_id}]
get_ai_provider_settingsB	Get Ai Provider Settings [GET /api/groups/ai-providers/settings]
update_ai_provider_settingsC	Update Ai Provider Settings [PUT /api/groups/ai-providers/settings]
get_all_householdsD	Get All Households [GET /api/groups/households]
get_one_householdC	Get One Household [GET /api/groups/households/{household_slug}]
get_logged_in_user_groupA	Get Logged In User Group [GET /api/groups/self] Returns the Group Data for the Current User
get_group_membersC	Get Group Members [GET /api/groups/members] Returns all users belonging to the current group
get_group_memberA	Get Group Member [GET /api/groups/members/{username_or_id}] Returns a single user belonging to the current group
get_group_preferencesC	Get Group Preferences [GET /api/groups/preferences]
update_group_preferencesC	Update Group Preferences [PUT /api/groups/preferences]
get_storageD	Get Storage [GET /api/groups/storage]

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

Server Configuration
Capabilities
Tools
Prompts
Resources

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/2fst4u/mealie-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server