Skip to content
MCP tools
View as Markdown
Creates dataHabitsMCP tool

habits_create

Create a new habit to track.

Create a new habit to track. The checklist and trackers are seeded automatically from the habit_type (bible/gym/throwing/reading/custom). Returns the created habit with its id and display_id (H-####). Cadence defaults to 'daily'. After creating, use habits_log to mark progress for a day.

Parameters#

ParameterTypeRequiredDescription
namestringYesName of the habit (e.g. "Read My Bible", "Go to the Gym")
habit_typeenumNoHabit type — seeds the default checklist + trackers (default: custom) · One of: bible, gym, throwing, reading, custom
cadenceenumNoHow often the habit recurs (default: daily) · One of: daily, weekly, monthly
weekly_targetnumberNoFor weekly cadence — target sessions per week (e.g. 4 for a gym habit) · Max: 7 · Min: 1
taglinestringNoA short reminder of the "why" behind the habit
started_onstringNoThe date the habit started (YYYY-MM-DD). Defaults to unset. (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD)

Example prompts#

  • "Add a new record under habits."

Safety#

Creates data. Creates a new record in your CRM and may trigger notifications or webhooks. Running it twice creates a duplicate, so Claude runs it once per request.