Skip to main content
Glama
Mealie MCP Server

Mealie MCP Server

by that0n3guy

Mealie MCP Server (TypeScript)

npm version

This project enables AI assistants to interact with your Mealie recipe database through MCP clients such as Claude Desktop.

Based on rldiao/mealie-mcp-server - rewritten in TypeScript.

Installation

npm install -g mealie-mcp-server-ts

Or run directly with npx:

npx mealie-mcp-server-ts

Related MCP server: Mealie MCP Server

Prerequisites

  • Node.js 18+

  • Running Mealie instance with API key

Usage with Claude Desktop

Add the server to your claude_desktop_config.json:

{
  "mcpServers": {
    "mealie": {
      "command": "npx",
      "args": [
        "-y",
        "mealie-mcp-server-ts"
      ],
      "env": {
        "MEALIE_BASE_URL": "https://your-mealie-instance.com",
        "MEALIE_API_KEY": "your-mealie-api-key"
      }
    }
  }
}

WSL Users

If running on Windows with WSL:

{
  "mcpServers": {
    "mealie": {
      "command": "wsl",
      "args": [
        "env",
        "MEALIE_BASE_URL=https://your-mealie-instance.com",
        "MEALIE_API_KEY=your-mealie-api-key",
        "npx",
        "-y",
        "mealie-mcp-server-ts"
      ]
    }
  }
}

Alternative: Local Installation

If you prefer to run from a local clone:

{
  "mcpServers": {
    "mealie": {
      "command": "node",
      "args": [
        "/path/to/mealie-mcp-server-ts/dist/index.js"
      ],
      "env": {
        "MEALIE_BASE_URL": "https://your-mealie-instance.com",
        "MEALIE_API_KEY": "your-mealie-api-key"
      }
    }
  }
}

Development

  1. Clone the repository and install dependencies:

npm install
  1. Copy the environment template and configure:

cp .env.template .env
  1. Edit the .env file with your Mealie instance details:

MEALIE_BASE_URL=https://your-mealie-instance.com
MEALIE_API_KEY=your-mealie-api-key
  1. Build the project:

npm run build
  1. Run the server:

npm start

License

This project is licensed under the MIT License - see the LICENSE file for details.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    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.
      7
      MIT
    • A
      license
      A
      quality
      C
      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
      480 npm
      8
      MIT
    • A
      license
      D
      quality
      B
      maintenance
      Provides complete access to Mealie's API for managing recipes, meal plans, shopping lists, households, and more via natural language from AI assistants.
      283
      21
      MIT