aid: mealie
name: Mealie
description: 'Mealie is an open-source (AGPL-3.0), self-hosted recipe manager, meal planner and shopping-list
  application built on a FastAPI REST backend and a Vue frontend. Every feature in the UI is driven
  by the same public REST API: recipe CRUD and import-by-URL scraping, AI-assisted recipe creation,
  cookbooks, meal plans and mealplan rules, shopping lists and list items with cross-application
  "extras" key/value pairs, households and groups with multi-purpose labels, food/unit/tool organizers,
  a public "Explore" surface for unauthenticated browsing of shared content, scheduled webhooks,
  Apprise-backed event notifications, and admin backup/maintenance operations. The instance publishes
  its own OpenAPI 3.1 document and interactive Swagger UI at /openapi.json and /docs, authenticates
  with long-lived bearer API tokens (plus OIDC and LDAP for user login), and shares a uniform pagination,
  filtering and ordering grammar across nearly every collection endpoint.'
image: https://avatars.githubusercontent.com/u/92342333?v=4
url: https://raw.githubusercontent.com/api-evangelist/mealie/refs/heads/main/apis.yml
x-type: company
x-source: harvest:health-device-stack
specificationVersion: '0.20'
created: '2026-08-27'
modified: '2026-08-27'
tags:
- Company
- Recipes
- Food
- Meal Planning
- Shopping Lists
- Self-Hosted
- Open Source
- Household
- Nutrition
- Home Automation
apis:
- name: Mealie API
  description: The Mealie REST API — 264 operations across 180 paths covering recipes, cookbooks,
    meal plans, shopping lists, households, groups, organizers, users, webhooks, event notifications
    and admin maintenance. Served by every Mealie instance from its own host; the project operates
    a public demo instance whose OpenAPI document is the harvested contract here.
  humanURL: https://docs.mealie.io/documentation/getting-started/api-usage/
  baseURL: https://demo.mealie.io/api
  tags:
  - Recipes
  - Meal Planning
  - Shopping Lists
  - Households
  properties:
  - type: OpenAPI
    url: openapi/mealie-openapi.json
  - type: Documentation
    url: https://docs.mealie.io/documentation/getting-started/api-usage/
  - type: APIReference
    url: https://demo.mealie.io/docs
  - type: Overlay
    url: overlays/mealie-openapi-overlay.yaml
  - type: Authentication
    url: authentication/mealie-authentication.yml
  - type: OAuthScopes
    url: scopes/mealie-scopes.yml
  - type: ErrorCatalog
    url: errors/mealie-problem-types.yml
  - type: DataModel
    url: data-model/mealie-data-model.yml
  - type: Conventions
    url: conventions/mealie-conventions.yml
  - type: RateLimits
    url: rate-limits/mealie-rate-limits.yml
  - type: Webhooks
    url: asyncapi/mealie-events.yml
  - type: Conformance
    url: conformance/mealie-conformance.yml
  - type: Lifecycle
    url: lifecycle/mealie-lifecycle.yml
  - type: Sandbox
    url: sandbox/mealie-sandbox.yml
  x-base-url-note: 'repair-api-bases.py returns `no-usable-base` for Mealie and it is right to flag
    it: demo.mealie.io is a demonstration host, not production. There IS no production host. Mealie
    is AGPL-3.0 self-hosted software, so the real base is templated — the docs say http(s)://<your-mealie-site>/api
    — and the only host the project itself operates and points integrators at is the public demo
    ("see the example at the Demo Site", https://docs.mealie.io/documentation/getting-started/api-usage/).
    baseURL is therefore recorded as https://demo.mealie.io/api: a real, reachable, provider-operated
    host that serves the harvested contract. The templated form https://{host}/api is carried in
    overlays/mealie-openapi-overlay.yaml, because the harvested spec declares no servers[] at all.'
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://mealie.io
- type: DeveloperPortal
  url: https://docs.mealie.io
- type: Documentation
  url: https://docs.mealie.io
- type: APIReference
  url: https://demo.mealie.io/docs
- type: GettingStarted
  url: https://docs.mealie.io/documentation/getting-started/introduction/
- type: Support
  url: https://github.com/mealie-recipes/mealie/discussions
- type: GitHubOrganization
  url: https://github.com/mealie-recipes
- type: SourceCode
  url: https://github.com/mealie-recipes/mealie
- type: Roadmap
  url: https://docs.mealie.io/documentation/getting-started/roadmap/
- type: Sandbox
  url: https://demo.mealie.io
- type: ChangeLog
  url: changelog/mealie-changelog.yml
- type: Releases
  url: https://github.com/mealie-recipes/mealie/releases
- type: Security
  url: security/mealie-vulnerability-disclosure.yml
- type: VulnerabilityDisclosure
  url: security/mealie-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/mealie-domain-security.yml
- type: Packages
  url: packages/mealie-packages.yml
- type: Plans
  url: plans/mealie-plans-pricing.yml
- type: LLMsTxt
  url: llms/mealie-llms.txt
- type: AgentSkill
  url: skills/_index.yml
- type: License
  url: https://github.com/mealie-recipes/mealie/blob/mealie-next/LICENSE
x-enrichment:
  date: '2026-08-27'
  status: enriched
  artifacts_added: 24
  pass: local-v1