Mcp Myfitnesspal

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:

``bash uv run python export_cookies.py ``

1. Deploy with the generated .env file - no browser needed!

See [Deployment Guide](docs/DEPLOYMENT.md) 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](docs/README.md) - Complete setup and usage guide
• [Deployment Guide](docs/DEPLOYMENT.md) - Docker, server, and cloud deployment
• [Quick Start Guide](docs/USAGE.md) - Fast setup instructions
• [Project Summary](docs/PROJECT_SUMMARY.md) - Architecture and design decisions
• [Implementation Notes](docs/IMPLEMENTATION_NOTES.md) - 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:

``bash 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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: linares222
• Source: linares222/mcp-myfitnesspal
• License: MIT

Install and usage instructions live in the source repository linked above.