mcp-myfitnesspal

ai-mcp-garage/mcp-myfitnesspal

3.2

If you are the rightful owner of mcp-myfitnesspal and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The MyFitnessPal MCP Server is a FastMCP server designed to retrieve nutrition data from MyFitnessPal using the Model Context Protocol.

MyFitnessPal MCP Server

A FastMCP server that retrieves your MyFitnessPal nutrition data through the Model Context Protocol.

Quick Start

Local Development

  1. Prerequisites: Python 3.12+, uv, MyFitnessPal account
  2. Install dependencies: uv sync
  3. Log into MyFitnessPal in your browser (Chrome, Firefox, Safari, or Edge)
  4. Test the server: uv run python test_client.py

Deployment (Server/Docker)

For environments without a browser:

  1. Export cookies from your local browser:

    uv run python export_cookies.py
    
  2. Deploy with the generated .env file - no browser needed!

See for Docker, systemd, and cloud deployment options.

Features

  • Daily nutrition summary (calories, macros, water)
  • Detailed meal-by-meal breakdown
  • Exercise tracking (cardio + strength)
  • Macro & micronutrient analysis
  • Water intake monitoring
  • Date range summaries with trends

Configuration

Add to your MCP client config (e.g., .cursor/mcp.json):

{
  "mcpServers": {
    "myfitnesspal": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mfp-mcp", "python", "main.py"]
    }
  }
}

Documentation

  • - Complete setup and usage guide
  • - Docker, server, and cloud deployment
  • - Fast setup instructions
  • - Architecture and design decisions
  • - Technical details

How It Works

Uses the python-myfitnesspal library (GitHub version) which:

  • Extracts cookies from your browser automatically
  • Scrapes MyFitnessPal website for data
  • No credentials stored in files
  • Works with Chrome, Firefox, Safari, and Edge

Cookie Authentication

Browser-based (default):

  • Automatically extracts cookies from your local browser
  • Works out of the box if you're logged into MyFitnessPal

Environment variable (for Docker/servers):

  • Set MFP_COOKIES environment variable with exported cookies
  • Use export_cookies.py utility to extract cookies beforehand:
    uv run python export_cookies.py
    
  • Perfect for environments without browser access (Docker containers, remote servers, etc.)
  • Cookies expire after ~30 days, re-export when needed

Project Structure

mfp-mcp/
├── docs/              # All documentation
├── myfitnesspal/      # External library (GitHub)
├── main.py            # FastMCP server
├── api_client.py      # Client wrapper
├── utils.py           # Helper functions
├── test_client.py     # Test script
└── pyproject.toml     # Dependencies

Requirements

  • Python 3.12+
  • uv package manager
  • Active MyFitnessPal session in browser
  • fastmcp 2.12+
  • lxml, browser-cookie3, measurement

License

For personal use and educational purposes. Respect MyFitnessPal's Terms of Service.

Credits