Skip to main content
Glama
that0n3guy

Mealie MCP Server

by that0n3guy
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

  • prep-itOAuth
    com.recipe-clipper

    Search, save, organize, cook, and share recipes with any AI assistant.

    Note TakingSearch
    2
  • SplotAOAuth
    health.splot

    Persistent food journal for AI assistants. Log meals, save recipes, plan meals and track nutrition.

    Fitness TrackingHealth & Wellness
    141
  • ask.recipesAOAuth
    recipes.ask

    Recipe search, ingredient matching, nutrition filters and a private cookbook for any AI agent.

    Health & WellnessKnowledge & MemorySearch
    161
  • scraps-kitchen-mcpAOAuth
    kitchen.scraps.api

    Scraps Kitchen gives any AI agent a persistent, household-aware kitchen memory. Unlike generic chatbot recall, Scraps maintains structured cooking data: what's in your fridge (with freshness tracking), who you cook for (with allergens, dietary restrictions, and preferences), your recipe collection (with cook notes and per-diner ratings), your shopping list, and your kitchen equipment. 27 tools across 6 domains let agents read kitchen context, suggest meals that respect dietary safety, update the pantry after cooking, and build a history of what works for your household. Every interaction makes the data richer. Cooking history, preference signals, kitchen awareness = better suggestions next time. All tools work via oAuth and a free scraps.kitchen account.

    App AutomationHome Automation & IoTKnowledge & Memory
    2

Related MCP Servers

  • Mealie MCP Server

    mdlopresti
    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.
    6
    MIT

  • mealie-mcp-ts

    counterbeing
    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
    1,664 npm
    7
    MIT