MCP.Market

Macrofactor MCP server

by NasserAlbusaidi·io.github.NasserAlbusaidi/macrofactor-mcp·v0.1.1·1 stars
No reviews yet

Fueling & recovery decision engine combining MacroFactor nutrition with Garmin training data

A88/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
New

1 stars

Reviews

Write one

Nobody has reviewed Macrofactor yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Macrofactor tools (30, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • analyze_meal_patterns

    Analyze meal timing, frequency, and which foods correlate with hitting targets.

  • body_comp_trend

    Track body composition over time — weight, body fat, training volume, energy balance.

  • clear_data

    Clear all imported data so you can reimport fresh exports.

  • daily_briefing

    Complete day view combining MacroFactor nutrition + Garmin health data.

  • data_status

    Check what data is currently loaded — date ranges, row counts, last import.

  • detect_phases

    Auto-detect cut/bulk/maintenance phases from weight trend and energy balance.

  • garmin_status

    Quick Garmin health snapshot for a date. No API calls — reads from synced DuckDB data.

  • get_combined_data

    Unified cross-domain query — returns merged nutrition + health data by date.

  • get_compliance_report

    Compare actual intake vs targets over a date range. Shows adherence.

  • get_digest

    Get a comprehensive weekly or monthly digest combining nutrition, weight, training, and adherence.

  • get_exercise_progress

    Track progress for a specific exercise over time.

  • get_food_log

    Get all foods logged on a specific date.

  • get_insights

    Get personalized insights based on your nutrition, training, sleep, and recovery data.

  • get_muscle_group_summary

    Get muscle group sets and volume summary. Defaults to last 7 days.

  • get_nutrition_range

    Get daily nutrition data for a date range.

  • get_nutrition_summary

    Get nutrition summary for a specific date.

  • get_weight_trend

    Get weight trend data. Defaults to last 30 days.

  • get_workout_history

    Get a summary of all workouts in a date range. Defaults to last 30 days.

  • get_workout_log

    Get workout details for a specific date.

  • import_export

    Import a MacroFactor .xlsx export file into the database.

  • list_exercises

    List all tracked exercises with available metrics.

  • main

    Initialize local data and run the MCP server over stdio.

  • nutrition_performance_correlation

    Correlate nutrition intake with next-day training metrics.

  • querywrite action

    Run a custom SQL query against the MacroFactor database.

  • recovery_check

    Readiness assessment — should you train hard today?

  • search_food

    Search logged foods by name across all dates.

  • setup_check

    Check local setup and explain the easiest next action.

  • sleep_analysis

    Analyze what affects sleep quality — prior-day training, calories, timing.

  • sync_garmin

    Sync Garmin health data into local DuckDB for fast cross-queries with MacroFactor data.

  • weekly_report

    Comprehensive 7-day report — nutrition, workouts, sleep, body, activity in one call.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan16 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 78 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Macrofactor compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 48,255 servers
Tools
30
the typical server has 7
Tools that change things
3%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 28,688 servers

What its tools let an agent do: 26 read · 1 create · 3 change

Install Macrofactor in Claude Code, Cursor or VS Code

claude mcp add macrofactor-mcp -- uvx macrofactor-mcp
Add to Cursor

What the publisher says

From the Macrofactor repository's README, as published. We do not edit it. Read it on GitHub

Am I recovered? Did my fueling work? What should change next week? The only MCP combining MacroFactor nutrition with Garmin training data.

MacroFactor MCP is a local Fueling & Recovery Decision Engine. Give your MCP client a MacroFactor export, optionally add Garmin, and ask for a decision instead of manually comparing nutrition, sleep, body, and training screens.

Quickstart

Install uv, then confirm the packaged server starts:

uvx macrofactor-mcp

Export your data from MacroFactor, put the .xlsx file in one local directory, and add this to your MCP client configuration. Use absolute paths.

{
  "mcpServers": {
    "macrofactor": {
      "command": "uvx",
      "args": ["macrofactor-mcp"],
      "env": {
        "MACROFACTOR_DATA_DIR": "/absolute/path/to/macrofactor-exports",
        "MACROFACTOR_DB_PATH": "/absolute/path/to/macrofactor.duckdb"
      }
    }
  }
}

Restart the MCP client. The server imports new workbooks on startup. Run setup_check, then ask one of the questions below. If a desktop client cannot find uvx, replace "uvx" with the absolute path returned by which uvx.

Four flagship workflows

All examples below use synthetic data.

recovery_check — Am I recovered?

Combines last night's sleep, HRV, body battery, training load, and yesterday's fueling into a readiness view.

Recovery Check: 2026-07-08
Sleep: 7h 38m, score 82; HRV +4 vs 7-day average
Training load: ACWR 1.08 (optimal)
Yesterday: 96% calorie target; 101% protein target
Overall: All systems go — 4 positive signals.

daily_briefing — What do today's signals say together?

Shows the day as one picture instead of separate nutrition and training logs.

Daily Briefing: 2026-07-08
Intake: 2,340 kcal (P 171g / F 72g / C 248g)
Adherence: 98% calories | 101% protein
Body Battery: 28 → 83 | Sleep: 7h 38m, score 82
Training: Productive | Load 612/568 (ACWR 1.08)

weekly_report — What should change next week?

Reviews seven days of nutrition, weight, workouts, sleep, and training load.

Weekly Report: 2026-07-02 to 2026-07-08
Average: 2,315 kcal | 168g protein
On target: calories 6/7 days | protein 7/7 days
Training: 4 sessions | Sleep: 7h 26m average
Next-week signal: fueling was consistent; protect sleep before adding load.

nutritionperformancecorrelation — Did my fueling work?

Compares nutrition with next-day Garmin recovery signals. It reports sample sizes so small or missing datasets stay visible.

Nutrition → Performance Correlation: 28 paired days
Protein >=90% target: next-day HRV 51 vs 45 (+6)
Protein >=90% target: sleep score 81 vs 76 (+5)
Energy deficit days: body battery 68 vs 75 (-7)
Observation: higher-protein days tended to precede better recovery.

MacroFactor-only or MacroFactor + Garmin

Garmin is optional. To enable it, point GARMINTOKENS at an existing local Garth/Garmin token directory, then run sync_garmin.

Platform support

  • macOS and Linux
  • Windows is untested
  • Python 3.10 or newer

Limitations

  • v0.1 requires a manual MacroFactor export; it does not connect to a MacroFactor API.
  • Garmin correlation workflows need overlapping MacroFactor and Garmin dates.
  • Correlations are observational, not proof that one behavior caused another outcome.
  • Import support follows the current MacroFactor Quick Export and All-Time Data workbook layouts.

Privacy

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Macrofactor: common questions

Is Macrofactor MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the Macrofactor safety report
How do I install Macrofactor?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Macrofactor need an API key?
No secret keys are declared. It reads 3 settings from the environment.
Is Macrofactor maintained?
The last commit was 117 days ago (2026-07-10). The latest release is v0.1.1.
How does Macrofactor compare with other MCP servers?
safety score 88/100 (higher than 75% of 48,255 servers); tools 30 (the typical server has 7); tools that change things 3% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.