Skip to main content
Glama

mealie-mcp

Mealie(セルフホスト型レシピマネージャー)をLLMから呼び出し可能なツールセットとして公開するModel Context Protocolサーバーです。Claude Desktop / Claude Code(またはその他のMCPクライアント)から、自身のMealieインスタンス上のレシピ検索、詳細取得、献立管理、買い物リストの編集が可能になります。

ツール

ツール

用途

search_recipes(query?, tags?, limit?)

レシピを検索。スラッグ、名前、説明、タグ、カテゴリを返します

get_recipe(slug)

指定したスラッグの完全なレシピJSONを取得

list_meal_plan(start_date, end_date)

指定した2つのISO日付間の献立エントリを取得

list_shopping_lists()

すべての買い物リストのIDと名前を取得

add_shopping_list_items(list_id, items[])

リストにフリーテキストのアイテムを追加

create_recipe(name)

空のレシピを作成。生成されたスラッグを返します

create_meal_plan_entry(date, entry_type, recipe_slug?, title?)

献立エントリを追加

Related MCP server: Mealie MCP Server

要件

  • Python 3.11以上

  • 稼働中のMealieインスタンス(セルフホスト型。Mealie v2でテスト済み)

  • 長期間有効なMealie APIトークン(Mealie UIの「ユーザープロフィール」→「APIトークン」から取得)

設定

.env.example.env にコピーし、値を入力してください:

cp .env.example .env

変数

必須

デフォルト

説明

MEALIE_URL

はい

MealieインスタンスのベースURL(例: http://localhost:9011 または http://mealie:9000

MEALIE_API_TOKEN

はい

Mealieから取得した長期間有効なベアラートークン

MCP_TRANSPORT

いいえ

sse

ローカルサブプロセス用には stdio、HTTPストリーミング用には sse

MCP_HOST

いいえ

0.0.0.0

SSEモードのバインドアドレス

MCP_PORT

いいえ

8000

SSEモードのバインドポート

インストールとローカル実行

pip install -e .
# stdio mode (for Claude Desktop):
MCP_TRANSPORT=stdio mealie-mcp
# sse/http mode (for docker-compose / remote clients):
MCP_TRANSPORT=sse MCP_PORT=8000 mealie-mcp

SSEエンドポイントは http://<host>:<port>/sse で提供されます。

Claude Desktopの設定

Claude Desktopの設定ファイル(macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json)を編集します:

{
  "mcpServers": {
    "mealie": {
      "command": "mealie-mcp",
      "env": {
        "MEALIE_URL": "http://localhost:9011",
        "MEALIE_API_TOKEN": "paste-your-token-here",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

mealie-mcpPATH にない場合は、command にバイナリのフルパスを指定するか(例: /Users/you/.venvs/mealie-mcp/bin/mealie-mcp)、Python経由で呼び出してください:

{
  "mcpServers": {
    "mealie": {
      "command": "python",
      "args": ["-m", "mealie_mcp"],
      "env": {
        "MEALIE_URL": "http://localhost:9011",
        "MEALIE_API_TOKEN": "paste-your-token-here",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

設定を編集した後、Claude Desktopを再起動してください。

Docker / docker-compose

Dockerfile が含まれています。スタンドアロンで実行する場合:

docker build -t mealie-mcp .
docker run --rm -p 8765:8000 \
  -e MEALIE_URL=http://host.docker.internal:9011 \
  -e MEALIE_API_TOKEN=your-token \
  mealie-mcp

既存のMealieスタックにサーバーを追加するには、docker-compose.snippet.yml を参照してください:

services:
  mealie-mcp:
    build:
      context: ./mealie-mcp
    depends_on:
      - mealie
    environment:
      MEALIE_URL: "http://mealie:9000"
      MEALIE_API_TOKEN: "${MEALIE_API_TOKEN}"
      MCP_TRANSPORT: "sse"
      MCP_HOST: "0.0.0.0"
      MCP_PORT: "8000"
    ports:
      - "8765:8000"

MCPクライアントで http://<docker-host>:8765/sse を指定してください。

サーバーの手動テスト

サーバーをSSEモードで実行している状態で、到達可能であることを確認します:

curl -N http://localhost:8000/sse

SSEイベントストリームが開くのが確認できるはずです。stdioモードの場合、ハンドシェイクはClaude Desktopが処理するため、HTTPエンドポイントはありません。

プロジェクト構成

mealie-mcp/
├── pyproject.toml
├── Dockerfile
├── docker-compose.snippet.yml
├── .env.example
├── README.md
└── src/mealie_mcp/
    ├── __init__.py
    ├── __main__.py        # CLI entry point (loads .env, dispatches transport)
    ├── server.py          # FastMCP server + tool definitions
    └── client.py          # Async httpx wrapper for the Mealie REST API

ライセンス

MIT

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to interact with Mealie for recipe management, meal planning, and shopping list operations. Supports searching and managing recipes, creating meal plans, and generating shopping lists from recipes or meal plans.
    5
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    A MCP server for Mealie recipe management. Exposes 43 tools and 1 prompt for AI assistants to search, create, and manage recipes, meal plans, shopping lists, categories, and tags.
    91
    6
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to manage recipes, meal plans, and shopping lists in Mealie through natural language, supporting CRUD operations and URL-based recipe imports.
    27
    1,621
    8
    MIT

View all related MCP servers

Related MCP Connectors

  • Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.

  • Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.

  • Bounded tools for rendering, extraction, RAG, enrichment, local discovery and review analysis.

View all MCP Connectors

Latest Blog Posts

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/eds3028/mealie-mcp'

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