Myfitnesspal

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 Deployment Guide 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

• Full Documentation - Complete setup and usage guide
• Deployment Guide - Docker, server, and cloud deployment
• Quick Start Guide - Fast setup instructions
• Project Summary - Architecture and design decisions
• Implementation Notes - 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

• python-myfitnesspal: https://github.com/coddingtonbear/python-myfitnesspal
• FastMCP: https://github.com/jlowin/fastmcp