list_goals
Lists goals of the organization, newest first; filter by status and time horizon. Requirements: role Viewer or higher, key scope "read" or higher, module "Goals" enabled.
- status
- Optional · string · active | completed | paused | draft — Only goals with this status.
- horizon
- Optional · string · long-term | mid-term | short-term — Only goals with this time horizon.
- limit
- Optional · number — Maximum number of results (default 50, max 200).
get_goal
Returns a goal by ID. Requirements: role Viewer or higher, key scope "read" or higher, module "Goals" enabled.
- id
- Required · string — ID of the goal.
create_goal
Creates a goal; you are stored as its creator. Without input it starts with horizon mid-term and status active. Use parentGoalId to place it under a parent goal. Requirements: role Member or higher, key scope "write" or higher, module "Goals" enabled.
- title
- Required · string — Title.
- description
- Optional · string — Description as free text.
- horizon
- Optional · string · long-term | mid-term | short-term — Time horizon. Default: mid-term.
- status
- Optional · string · active | completed | paused | draft — Initial status. Default: active.
- targetDate
- Optional · string — Target date (ISO 8601).
- parentGoalId
- Optional · string — ID of the parent goal.
update_goal
Updates a goal: title, description, status, manual progress (0–100) or target date. Only the fields you send are changed. Requirements: role Member or higher, key scope "write" or higher, module "Goals" enabled.
- id
- Required · string — ID of the goal.
- title
- Optional · string — Title.
- description
- Optional · string — Description as free text.
- status
- Optional · string · active | completed | paused | draft — New status.
- manualProgress
- Optional · number — Manual progress in percent (0–100; values outside are clamped).
- targetDate
- Optional · string — New target date (ISO 8601); an empty value removes it.
delete_goal
Deletes a goal. Requires at least the Admin role and a key with the delete scope. Requirements: role Admin or higher, key scope "delete" or higher, module "Goals" enabled.
- id
- Required · string — ID of the goal.
list_metrics
Lists the KPI metrics of the organization, newest first; filter by status. Requirements: role Viewer or higher, key scope "read" or higher, module "Metrics" enabled.
- status
- Optional · string · on-track | at-risk | off-track — Only metrics with this status.
- limit
- Optional · number — Maximum number of results (default 50, max 200).
get_metric
Returns a metric by ID. Requirements: role Viewer or higher, key scope "read" or higher, module "Metrics" enabled.
- id
- Required · string — ID of the metric.
create_metric
Creates a KPI metric. Name and target value are required; without input it starts with a current value of 0 and status on-track. Requirements: role Member or higher, key scope "write" or higher, module "Metrics" enabled.
- name
- Required · string — Name of the metric.
- description
- Optional · string — Description as free text.
- unit
- Optional · string — Unit, e.g. %, users, €.
- targetValue
- Required · number — Target value of the metric.
- currentValue
- Optional · number — Current value of the metric.
- status
- Optional · string · on-track | at-risk | off-track — Initial status. Default: on-track.
update_metric
Updates a metric – typically its current value or status. Target value, name and description can be changed too; the unit cannot. Requirements: role Member or higher, key scope "write" or higher, module "Metrics" enabled.
- id
- Required · string — ID of the metric.
- currentValue
- Optional · number — Current value of the metric.
- targetValue
- Optional · number — Target value of the metric.
- status
- Optional · string · on-track | at-risk | off-track — New status.
- name
- Optional · string — New name of the metric.
- description
- Optional · string — Description as free text.
delete_metric
Permanently deletes a metric. Requires at least the Admin role and a key with the delete scope. Requirements: role Admin or higher, key scope "delete" or higher, module "Metrics" enabled.
- id
- Required · string — ID of the metric.
list_reviews
Lists weekly reviews of the organization, by week start descending. This tool has no module switch and is always available. Requirements: role Viewer or higher, key scope "read" or higher, no module switch (always available).
- limit
- Optional · number — Maximum number of results (default 20, max 100).
get_review
Returns a single weekly review by ID. Requirements: role Viewer or higher, key scope "read" or higher, no module switch (always available).
- id
- Required · string — ID of the review.
create_review
Creates a weekly review; only the week start (Monday) is required. You are stored as its creator. Requirements: role Member or higher, key scope "write" or higher, no module switch (always available).
- weekStart
- Required · string — Monday of the week (ISO 8601).
- wentWell
- Optional · string — What went well.
- didntGoWell
- Optional · string — What did not go well.
- focusNextWeek
- Optional · string — Focus for the coming week.
- highlights
- Optional · string — Highlights of the week.
- mood
- Optional · number — Mood rating from 1 to 5.
update_review
Updates fields of a weekly review (what went well, what did not, focus, highlights, mood); only the fields you send are changed. The week start cannot be changed. Requirements: role Member or higher, key scope "write" or higher, no module switch (always available).
- id
- Required · string — ID of the review.
- wentWell
- Optional · string — What went well.
- didntGoWell
- Optional · string — What did not go well.
- focusNextWeek
- Optional · string — Focus for the coming week.
- highlights
- Optional · string — Highlights of the week.
- mood
- Optional · number — Mood rating from 1 to 5.
delete_review
Permanently deletes a weekly review. Requires at least the Admin role and a key with the delete scope. Requirements: role Admin or higher, key scope "delete" or higher, no module switch (always available).
- id
- Required · string — ID of the review.
Common pitfalls
Progress is clamped
update_goal clamps manualProgress to 0–100.
The unit cannot be changed
You set a metric's unit with create_metric; update_metric cannot change it.
Week start is fixed
A weekly review's week start cannot be changed after creation; create a new one if needed.