DailyGoal API

Scripts, dashboards and AI agents can read and change your own DailyGoal data. The REST API and the remote MCP server are built from one definition, so they offer the same operations with the same inputs, outputs and errors.

The DailyGoal API is not available on the Free plan. It works with a paid plan or during a free trial. See plans.

Endpoints

REST base URL: https://api.dailygoal.fit/v1
MCP server: https://api.dailygoal.fit/v1/mcp, stateless streamable HTTP with JSON responses
OpenAPI 3.1 spec: https://api.dailygoal.fit/v1/openapi.json
Agent-readable guide: https://api.dailygoal.fit/v1/llms.txt

Your first request

Create an API token in your DailyGoal settings, then ask for your context. Every agent should make this call first: it returns today's Activity Day, your timezone and your preferred units, so writes land on the right day in the right units.

bash

curl "https://api.dailygoal.fit/v1/me" \
  -H "Authorization: Bearer $DAILYGOAL_API_TOKEN"

Operations available today

The reference lists all 47 operations in the shipped catalogue.

get_context (GET /v1/me): Get context
get_profile_settings (GET /v1/profile): Get profile settings
update_profile_settings (PATCH /v1/profile): Update profile settings
list_body_metrics (GET /v1/body-metrics): List body metrics
set_body_metrics (PUT /v1/body-metrics): Set body metrics
delete_body_metric (DELETE /v1/body-metrics): Delete body metric
list_water (GET /v1/water): List water
set_water (PUT /v1/water): Set water
delete_water (DELETE /v1/water): Delete water
search_foods (GET /v1/foods): Search foods
list_food_entries (GET /v1/food-entries): List food entries
log_food_entry (POST /v1/food-entries): Log food entry
update_food_entry (PATCH /v1/food-entries): Update food entry
delete_food_entry (DELETE /v1/food-entries): Delete food entry
get_daily_nutrition (GET /v1/nutrition): Get daily nutrition
save_custom_food (POST /v1/custom-foods): Save custom food
delete_custom_food (DELETE /v1/custom-foods): Delete custom food
list_favorite_foods (GET /v1/favorite-foods): List favourite foods
set_favorite_food (PUT /v1/favorite-foods): Set favourite food
list_recent_foods (GET /v1/recent-foods): List recent foods
get_saved_meal (GET /v1/saved-meals): Get saved meal
save_saved_meal (POST /v1/saved-meals): Save saved meal
delete_saved_meal (DELETE /v1/saved-meals): Delete saved meal
search_exercises (GET /v1/exercises): Search exercises
list_workouts (GET /v1/workouts): List workouts
get_workout (GET /v1/workouts/detail): Get workout
log_workout (POST /v1/workouts): Log workout
replace_workout (PUT /v1/workouts): Replace workout
delete_workout (DELETE /v1/workouts): Delete workout
list_workout_templates (GET /v1/workout-templates): List workout templates
get_workout_template (GET /v1/workout-templates/detail): Get workout template
save_workout_template (POST /v1/workout-templates): Save workout template
delete_workout_template (DELETE /v1/workout-templates): Delete workout template
list_workout_presets (GET /v1/workout-presets): List workout presets
list_gym_profiles (GET /v1/gym-profiles): List gym profiles
save_gym_profile (POST /v1/gym-profiles): Save gym profile
set_default_gym_profile (PUT /v1/gym-profiles/default): Set default gym profile
delete_gym_profile (DELETE /v1/gym-profiles): Delete gym profile
list_goals (GET /v1/goal-templates): List goals
save_goal (POST /v1/goal-templates): Save goal
delete_goal (DELETE /v1/goal-templates): Delete goal
get_daily_goals (GET /v1/daily-goals): Get daily goals
set_goal_progress (PUT /v1/daily-goals): Set goal progress
get_streak (GET /v1/progress/streak): Get streak
list_badges (GET /v1/progress/badges): List badges
get_strength_progress (GET /v1/progress/strength): Get strength progress
get_recent_focus (GET /v1/progress/recent-focus): Get recent focus

Guides

MCP quickstart: connect an MCP client with OAuth or an API token, with each client's verification status.
Authentication: API tokens, connected apps, paid access and rate limits.
Errors: every error code and what to do next.

MCP behavior and annotations

DailyGoal exposes tools only, with no MCP resources, prompts or widgets. Send a single JSON-RPC message per POST. The server returns JSON, uses no session id and offers no event stream; GET and DELETE on the MCP URL return 405. Every protocol request needs a valid credential. Paid access and request limits apply to tool calls.

Each tool's readOnlyHint says whether it leaves domain data unchanged. destructiveHint marks operations that may delete or overwrite data, including save tools that can replace an existing item. openWorldHint: false means the tool operates on DailyGoal data rather than arbitrary outside systems. These hints describe behavior; they do not grant permission or replace your client's confirmation controls.

Versioning

/v1 only takes additive changes. A breaking change ships as /v2, announced on this page at least six months before /v1 changes. For MCP, renaming a tool or adding a required input counts as a breaking change.

Your data and your terms

A program you connect acts on your account and receives the data it asks for. The Privacy Policy explains what connected programs receive, and the Terms of Use cover your responsibility for tokens and apps you set up.