Momentum

Permanently delete a routine. By default its habits are preserved and unassigned; habitPolicy=delete also permanently deletes those habits and logs. Call only after explicit confirmation.

delete_routine

Permanently delete one task. Call only after the user explicitly confirms deletion.

delete_task

Permanently delete one personal attempt after explicit confirmation; optionally delete its definition only when no attempts remain.

delete_personal_program

Get one connected-user-owned definition, its current canonical revision, hash, and attempt summaries.

get_personal_program

Check whether free personal-program drafting is enabled, whether Pro is active for later execution, and whether the installed Momentum client supports every schema, habit, and lesson type.

get_program_authoring_capabilities

Read today's stored log for a habit selected by habitId or exact habitName. The result includes the daily value and completion plus type-specific data: counter/timer/slider/activity individual entries, checklist selections, journal/text reflections, commitment outcome, and lesson responses. Use this after list_habits whenever the user asks what was logged or today's progress.

get_habit_today

Bulk import up to 200 past daily snapshots for one existing habit. The server reads the habit type and validates each record accordingly: checkbox uses completed; counter/timer use the full daily total in value; rating/slider/measurement use value; checklist uses checklistItemsToComplete as the complete item set for that day; journal uses reflection; activity uses durationMinutes; commitment uses outcome. For complex habit history where the source only reports whether the day was complete, send completed without invented detail; Momentum marks that record as summary-only. Existing daily logs are always preserved and skipped. Dates must be before today, duplicate dates are rejected, the batch is atomic, and idempotencyKey must be reused on retries. Call only after showing the user the habit, date range, record count, and expected level of detail and receiving explicit confirmation.

import_habit_history

List the connected user's habit definitions, IDs, tracking types, schedules, targets, and streaks, optionally filtered to one routine. This does not return daily logs; when the user asks about today's progress or recorded entries, call get_habit_today for the relevant habits.

list_habits

List the connected user's routines (named groupings of habits).

list_routines

List tasks scheduled for a calendar date, including incomplete rollover tasks from earlier dates.

list_tasks

List only the connected user's private personal-program definitions and attempts.

list_personal_programs

Record today's value for a habit selected by habitId or exact habitName. For counter and timer, value is a positive increment added to today's cumulative total and stored as an individual entry with its optional note. For rating and measurement, value replaces today's recorded value; slider stores the latest value plus each check-in. For checklist, use checklistItemsToComplete/checklistItemsToClear so existing item state is preserved. Use reflection for journal; durationMinutes and optional isOutdoors for activity; outcome for commitment; and completed/reflection for checkbox, text_note, or slide_lesson. Rating, slider, checklist, journal, measurement, activity, and commitment completion is calculated from the structured data and rejects completed overrides. Photo check-ins must be completed in the Momentum app because MCP cannot attach the required device-local photo. Use idempotencyKey for additive counter, timer, slider, and activity entries. Read the resulting log with get_habit_today.

log_habit_today

Validate a future-only revision and return its exact hash and change summary without writing.

preview_personal_program_revision

Mark an existing Momentum task complete or incomplete.

set_task_completion

Change an existing habit selected by habitId or exact habitName. Names must be unique; use habitId when duplicate names exist.

update_habit

Change an existing routine's name, emoji, color, or description.

update_routine

Change the text, due date, rollover behavior, tag, or notes of an existing task.

update_task

Validate, safety-check, canonicalize, and hash a draft without writing anything. Show the warnings and exact canonical draft to the user before creation.

validate_personal_program