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

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

Clone the repository and install dependencies:

npm install

Copy the environment template and configure:

cp .env.template .env

Edit the .env file with your Mealie instance details:

MEALIE_BASE_URL=https://your-mealie-instance.com
MEALIE_API_KEY=your-mealie-api-key

Build the project:

npm run build

Run the server:

npm start

License

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