Back to Directory/Developer Tools

io.github.fliptheweb/yazio-mcp

MCP server for accessing Yazio user & nutrition data (unofficial)

Developer ToolsJavaScriptv0.0.13

Yazio MCP Server Yazio Logo

[!IMPORTANT] This is not an official MCP server and Yazio does not provide an official API. This server uses an unofficial reverse-engineered API and may stop working at any time.

An MCP (Model Context Protocol) server that connects Claude/Cursor to your Yazio nutrition data. Track your diet, search food products, and manage your nutrition goals directly from your AI assistant.

Available on NPM: npx yazio-mcp

Claude Desktop Extension: yazio-mcp.mcpb — one-click install is broken upstream, see workaround.

✨ Features

  • 🔐 Authentication - Connect with your Yazio account
  • 📊 Nutrition Analysis - Get comprehensive diet data and insights
  • 🍎 Food Tracking - Search, add, and manage food entries
  • 🏃‍♂️ Fitness Data - Track exercises and water intake
  • ⚖️ Weight Monitoring - View weight history and trends
  • 🎯 Goal Management - Access and manage nutrition goals
  • 🔍 Product Search - Search Yazio's extensive food database

🚀 Quick Start

Add the following JSON your MCP client configuration:

{
  "mcpServers": {
    "yazio": {
      "command": "npx",
      "args": ["-y", "yazio-mcp"],
      "env": {
        "YAZIO_USERNAME": "your_email@emai.com",
        "YAZIO_PASSWORD": "your_password"
      }
    }
  }
}

Claude Desktop (Extension)

[!WARNING] One-click .mcpb install is broken by a Claude Desktop bug (mcpb#281). Workaround: download yazio-mcp.zip, extract it, and use Settings → Extensions → Advanced settings → Install Unpacked Extension. Or just use the npx config above.

Claude Desktop (Manual)

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code (CLI)

claude mcp add yazio -e YAZIO_USERNAME=your_email@email.com -e YAZIO_PASSWORD=your_password -- npx -y yazio-mcp

Verify with claude mcp list.

Cursor

There are a few ways to add the server:

  • Settings UI (easiest) — Settings → MCP → + Add new MCP server, then fill in the command, args, and env
  • Project config — add JSON to .cursor/mcp.json in your project root
  • Global config — add JSON to ~/.cursor/mcp.json (applies to all projects)

💡 Use Cases

Showcase

📈 Analyze Your Nutrition Trends

"Get my nutrition data for the last week and analyze my eating patterns"

Claude can retrieve your daily summaries, identify trends, and provide insights about your eating habits, macro distribution, and areas for improvement.

🔍 Search Food Products

"Search for 'chicken breast' in the Yazio database"

Find detailed nutritional information for any food product, including calories, macros, vitamins, and minerals.

📝 Add Forgotten Meals

"Add 200g of grilled salmon for yesterday's dinner"

Easily log meals you forgot to track in the Yazio app directly from Claude or Cursor.

🛠️ Available Tools

ToolDescriptionKey Parameters
get_user_daily_summaryGet daily nutrition summarydate
get_user_consumed_itemsGet food entries for a datedate
get_user_weightGet weight data-
get_user_exercisesGet exercise datadate
get_user_water_intakeGet water intakedate
get_user_goalsGet nutrition goals-
get_user_settingsGet user preferences-
search_productsSearch food databasequery
get_productGet detailed product infoid
add_user_consumed_itemAdd food to your logproductId, amount, date, mealType
add_user_water_intakeAdd water intake entry (cumulative value in ml)date, water_intake
remove_user_consumed_itemRemove food from logitemId

Test Connection

YAZIO_USERNAME='your_email' YAZIO_PASSWORD='your_password' npx yazio-mcp

⚠️ Important Disclaimers

  • Unofficial API: This uses a reverse-engineered API that may break
  • Credentials: Your Yazio credentials are only used for auth on Yazio servers
  • Use at Your Own Risk: API changes could affect functionality

📋 Requirements

  • Node.js 18+ (for npx)
  • Valid Yazio account
  • MCP-compatible client (Claude Desktop, Cursor, etc.)

Development

  1. Download the repository
  2. Point to local copy in your mcp config
  3. Debugging:
YAZIO_USERNAME=X YAZIO_PASSWORD=X npx -y @modelcontextprotocol/inspector npx <local-path>/yazio-mcp

📄 License

MIT License - see LICENSE file for details.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y yazio-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-fliptheweb-yazio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "yazio-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

yazio-mcpnpm

Compatible MCP Clients

io.github.fliptheweb/yazio-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More