Mealie

Provides an MCP interface to query and interact with your Mealie recipe database via MCP clients.

typescript

0

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You run a Mealie MCP Server to let AI assistants securely access your Mealie recipe database. This server acts as a bridge between MCP clients and Mealie, enabling tasks like querying recipes, retrieving ingredients, and performing actions through natural language interfaces.

How to use

Launch the MCP server to expose your Mealie instance to MCP clients such as Claude Desktop. Connect by configuring your MCP client to point at the server, then use the client’s prompts to interact with your recipe data. You can run the server in a straightforward way with a quick startup command, or use a Windows Subsystem for Linux (WSL) setup if you are on Windows. If you prefer running locally from a clone, you can point the client at a local execution path.

How to install

Prerequisites you need before starting: Node.js 18 or newer, and a running Mealie instance with an API key.

# Option A: Install globally and run
npm install -g mealie-mcp-server-ts

# Start the server
mealie-mcp-server-ts

# Option B: Run with npx without installing globally
npx mealie-mcp-server-ts

Configuration and usage examples

Configure your MCP client to load the server and provide your Mealie instance details. The examples below show how to set up the server to connect to your Mealie instance using an API key.

{
  "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 you are on Windows and use Windows Subsystem for Linux (WSL), you can run the MCP server through WSL to access your Mealie instance.

{
  "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 from a clone

If you prefer to run from a local clone, point the server at the built JavaScript entry in your environment.

{
  "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"
      }
    }
  }
}

Notes on development and running

When developing locally, you can build and run from source to test changes. Install dependencies, copy the environment template, configure your credentials, build, and start the server.

npm install
cp .env.template .env
# Edit .env to set your details
# MEALIE_BASE_URL=https://your-mealie-instance.com
# MEALIE_API_KEY=your-mealie-api-key

npm run build
npm start