set_preferences — MCP tool

added 2026-10-01needs the account scopecan overwrite dataidempotent

Change your settings (time zone, e-mail, theme, formats, display options); only the fields you pass change. Needs the separate mcp:account scope (OAuth grant only, off by default; mcp:write does not include it). time_zone is an IANA name such as Asia/Baku (empty clears: UTC); email_mode is off, instant or daily; default_project_view is the view a project opens in (default resets it to board); theme is the web app's theme: light, dark, system or default (= system). time_format is 24h (default) or 12h, date_format is DD.MM.YYYY (default), YYYY-MM-DD or MMM D, YYYY, week_start is monday (default) or sunday; each also accepts default to reset it, and case is ignored. display changes the Display options of project; only the options you pass change: ordering (manual, priority, updated, created), showSubtasks (true or false), doneRecent, collapsedStatuses (status keys), cardProperties (labels, comments; [] neither), treeDepth (epics, stories, all), treeShowDone, treeProgress, treeStatus, treeAssignee; an option set to null goes back to its default. A bad value changes nothing.

date_formatenumoptional
How the web app shows dates; default (or an empty string) resets it to DD.MM.YYYY
DD.MM.YYYYYYYY-MM-DDMMM D, YYYYdefault
default_project_viewenumoptional
The view a project opens in (map is the Topology view); default (or an empty string) resets it to board
boardlisttreemapdefault
displayobjectoptional
Display options of project, only the ones you pass change; null resets one to its default
email_modeenumoptional
How notifications are e-mailed
offinstantdaily
projectstringoptional
Project key the display options below belong to
themeenumoptional
The web app's theme; default (or an empty string) resets it to system
lightdarksystemdefault
time_formatenumoptional
How the web app shows times; default (or an empty string) resets it to 24h
24h12hdefault
time_zonestringoptional
IANA time zone name, e.g. Asia/Baku; empty string clears it
week_startenumoptional
The day the web app's calendars start the week on; default (or an empty string) resets it to monday
mondaysundaydefault

Returns

date_formatanyrequired
DD.MM.YYYY, YYYY-MM-DD or MMM D, YYYY
default_project_viewanyrequired
displayobject | nullrequired
By project key (get_preferences with project fills in defaults)
email_availablebooleanrequired
email_modestringrequired
off, instant or daily
planobjectoptional
Your plan, its limits and what you use (get_preferences only; absent when plans are not enabled)
sidebarobject | nullrequired
collapsed, openProjectId; null: never changed
themestringrequired
light, dark or system
theme_unsetbooleanoptional
true when no theme was ever set (system is the default)
time_formatanyrequired
24h or 12h
time_zonestring | nullrequired
IANA name; null: not set (UTC)
week_startanyrequired
monday or sunday

2026-10-12 — display takes collapsedStatuses; showDone is refused.
2026-10-01 — New time_format (24h or 12h), date_format (DD.MM.YYYY, YYYY-MM-DD or MMM D, YYYY) and week_start (monday or sunday): how the web app shows times and dates and which day its calendars start on; default resets each. They do not change the ISO 8601 timestamps of tool outputs.
2026-10-03 — Also answers structuredContent (see outputSchema); a failed call adds structuredContent.error. Text unchanged. Details: /docs/mcp, "Structured results and errors".
2026-10-04 — Claude Code 2.1.288+ (clientInfo claude-code): the text of a successful answer is itself up to 512 bytes, else "Result in structuredContent (N bytes)."; structuredContent and errors are unchanged. See /docs/mcp.