Skip to content
Agentmart
Submit a tool

Macrofactor MCP

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

Connector by NasserAlbusaidi · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 2
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/nasseralbusaidi-macrofactor-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
21 read · 2 write · 1 delete · 5 not yet classified
Secrets
None asked for
Install scripts
Not scanned yet
Runs as
Python package

Tools by what they do 29

Read from the source code; the running server may list different tools.

Read 21 · Look things up without changing anything.

  • analyze_meal_patterns
  • data_status
  • detect_phases
  • garmin_status
  • get_combined_data
  • get_compliance_report
  • get_digest
  • get_exercise_progress
  • get_food_log
  • get_insights
  • get_muscle_group_summary
  • get_nutrition_range
Show 9 more tools
  • get_nutrition_summary
  • get_weight_trend
  • get_workout_history
  • get_workout_log
  • list_exercises
  • recovery_check
  • search_food
  • setup_check
  • sleep_analysis

Write 2 · Create, change, send or run things.

  • import_export
  • sync_garmin

Delete 1 · Delete, drop, revoke or wipe things.

  • clear_data

Not yet classified 5 · We could not tell from the name and description.

  • body_comp_trend
  • daily_briefing
  • nutrition_performance_correlation
  • query
  • weekly_report

Secrets and settings it asks for

Other settings (environment variables or headers).

  • GARMINTOKENS
  • MACROFACTOR_DATA_DIR
  • MACROFACTOR_DB_PATH

Files it touches

  • Any path the agent passes to its tools

Tools (29)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • analyze_meal_patterns

    Analyze meal timing, frequency, and which foods correlate with hitting targets. Shows when you eat, how many meals per day, most frequent foods, and which foods appear most on days where you hit your calorie and protein targets. Args: start_date: Start date (YYYY-MM-DD). Default: 30 days ago. end_date: End date (YYYY-MM-DD). Default: today. limit: Max foods to show per category (default 15).

  • body_comp_trend

    Track body composition over time — weight, body fat, training volume, energy balance. Answers: am I gaining muscle or fat? Combines weight trend with body fat, training volume, and calorie surplus/deficit. Args: start_date: Start date (YYYY-MM-DD). Default: 90 days ago. end_date: End date (YYYY-MM-DD). Default: today.

  • clear_data

    Clear all imported data so you can reimport fresh exports.

  • daily_briefing

    Complete day view combining MacroFactor nutrition + Garmin health data. The cross-data tool — shows nutrition, adherence, body, activity, sleep, and training in one view. No API calls — reads from DuckDB. Args: date_str: Date in YYYY-MM-DD format. Empty = today.

  • 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. Analyzes the full history and identifies distinct phases based on trend weight direction and caloric balance. Each phase shows duration, weight change, and average deficit/surplus. Args: min_days: Minimum days for a phase to be reported (default 14).

  • garmin_status

    Quick Garmin health snapshot for a date. No API calls — reads from synced DuckDB data. Combines daily stats, sleep, and training status in one view. Run sync_garmin first to populate data. Args: date_str: Date in YYYY-MM-DD format. Empty = today.

  • get_combined_data

    Unified cross-domain query — returns merged nutrition + health data by date. One call replaces multiple tool calls. Returns all requested domains in one payload. Args: start_date: Start date (YYYY-MM-DD). Default: 7 days ago. end_date: End date (YYYY-MM-DD). Default: today. domains: List of domains to include. Options: nutrition, weight, sleep, training, activity, workouts. Default: all.

  • get_compliance_report

    Compare actual intake vs targets over a date range. Shows adherence. Args: start_date: Start date (YYYY-MM-DD) end_date: End date (YYYY-MM-DD)

  • get_digest

    Get a comprehensive weekly or monthly digest combining nutrition, weight, training, and adherence. One call instead of five — gives a complete picture of a period. Args: period: "week" (last 7 days) or "month" (last 30 days). end_date: End date (YYYY-MM-DD). Default: today.

  • get_exercise_progress

    Track progress for a specific exercise over time. Args: exercise: Exercise name (case-insensitive, partial match). metric: One of: estimated_1rm, estimated_3rm, estimated_10rm, total_volume, best_set_volume, heaviest_weight, total_reps, best_set_reps, total_sets, total_duration, best_set_duration, total_distance, best_set_distance. limit: Max data points to return (default 20, most recent).

  • get_food_log

    Get all foods logged on a specific date. Args: date_str: Date (YYYY-MM-DD). Default: today.

  • get_insights

    Get personalized insights based on your nutrition, training, sleep, and recovery data. Analyzes cross-domain patterns specific to YOUR data. Includes: - Current state (phase, weight trajectory, weekly nutrition pacing) - Trend alerts (sleep, HRV, body battery, compliance changes) - Personal correlations (what actually affects YOUR recovery) - Actionable recommendations prioritized by urgency - Sparkline trends for key metrics Works best with both MacroFactor and Garmin data synced. No arguments needed — analyzes everything automatically.

  • get_muscle_group_summary

    Get muscle group sets and volume summary. Defaults to last 7 days. Args: start_date: Start date (YYYY-MM-DD) end_date: End date (YYYY-MM-DD)

  • get_nutrition_range

    Get daily nutrition data for a date range. Args: start_date: Start date (YYYY-MM-DD) end_date: End date (YYYY-MM-DD)

Show 14 more tools
  • get_nutrition_summary

    Get nutrition summary for a specific date. Args: date_str: Date in YYYY-MM-DD format. Empty = today.

  • get_weight_trend

    Get weight trend data. Defaults to last 30 days. Args: start_date: Start date (YYYY-MM-DD). Default: 30 days ago. end_date: End date (YYYY-MM-DD). Default: today.

  • get_workout_history

    Get a summary of all workouts in a date range. Defaults to last 30 days. Args: start_date: Start date (YYYY-MM-DD) end_date: End date (YYYY-MM-DD)

  • get_workout_log

    Get workout details for a specific date. Args: date_str: Date (YYYY-MM-DD). Default: most recent workout.

  • import_export

    Import a MacroFactor .xlsx export file into the database. Supports both Quick Export and All-Time Data formats. If filename is empty, auto-detects the most recent .xlsx in the data directory. Args: filename: Path to .xlsx file, or empty to auto-detect.

  • list_exercises

    List all tracked exercises with available metrics.

  • nutrition_performance_correlation

    Correlate nutrition intake with next-day training metrics. Shows whether protein/calorie intake patterns affect next-day body battery, HRV, and workout performance. Splits days into high/low intake buckets. Args: start_date: Start date (YYYY-MM-DD). Default: 30 days ago. end_date: End date (YYYY-MM-DD). Default: today.

  • query

    Run a custom SQL query against the MacroFactor database. Available tables: - daily: date, calories, macros, targets, weight, expenditure, steps, micros - food_log: date, time, food details (from Quick Export) - workouts: date, exercise, sets, reps, weight (from Quick Export) - muscle_sets: date, muscle_group, sets - muscle_volume: date, muscle_group, volume_kg - exercise_tracking: date, exercise, metric, value (from All-Time) - body_metrics: date, metric, value - custom_foods: food_name, nutrition info - nutrition_targets: program_date, weekday, targets - food_log_notes: d…

  • recovery_check

    Readiness assessment — should you train hard today? Combines last night's sleep, body battery, training load ratio, and yesterday's nutrition compliance into a single readiness view. Args: date_str: Date to check (YYYY-MM-DD). Default: today.

  • search_food

    Search logged foods by name across all dates. Also searches custom foods if no log results found. Args: query: Search term (case-insensitive). limit: Max results (default 20).

  • setup_check

    Check local setup and explain the easiest next action. Use this first when the MCP seems empty, stale, misconfigured, or when you are not sure which tool to call next. Args: show_workflows: Include common question-to-tool workflows.

  • sleep_analysis

    Analyze what affects sleep quality — prior-day training, calories, timing. Correlates sleep scores with training intensity, total calories, and meal timing from the preceding day. Args: start_date: Start date (YYYY-MM-DD). Default: 30 days ago. end_date: End date (YYYY-MM-DD). Default: today.

  • sync_garmin

    Sync Garmin health data into local DuckDB for fast cross-queries with MacroFactor data. Pulls daily stats, activities, sleep, training status, and body fat from Garmin Connect for the last N days. Data is upserted (idempotent). Args: days: Number of days to sync (default 7).

  • weekly_report

    Comprehensive 7-day report — nutrition, workouts, sleep, body, activity in one call. Includes daily detail for weight and nutrition, full workout breakdown with merged MacroFactor + Garmin strength data, sleep trends, and training load. Args: end_date: Last day of the week (YYYY-MM-DD). Default: today.

Signals

Stars
2
Forks
0
Open issues
0
Weekly downloads
30
Last commit
Jul 10, 2026 (3 months ago)
Last release
Jul 10, 2026 (3 months ago)
Last package publish
Jul 10, 2026 (3 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.NasserAlbusaidi/macrofactor-mcp
Version
0.1.1
Auth
No auth
Packages
pypi macrofactor-mcp
License
MIT
Repository
github.com/NasserAlbusaidi/macrofactor-mcp
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Macrofactor MCP. Agent Mart. https://agentmart.dev/connectors/nasseralbusaidi-macrofactor-mcp (last updated 2026-10-24)