get_project_settings
A project's settings by project id, every key present with the workspace default filled in, from sprint length and working days to estimation, workflow flags, business hours and alert routing.
Return a project's settings with every key present: how long a sprint runs and on which days, the timezone deadlines are read in, what work is sized in and on which scale, who a new item goes to, the workflow flags, whether guests may comment and Heimdall assists, the Telegram group, the board's limits and hidden columns, the business hours and whether a production outage opens an incident. Read it before planning a sprint, sizing a story or reading a deadline, so you count the days, the hours and the points the way the project does.
A guest token is refused: the settings are the team's, not the client's.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
project_id*stringUUID of the project whose settings to fetch.
What it returns
{ "data": { "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "sprint_length_days": 14, "working_days": [1, 2, 3, 4, 5], "timezone": "Asia/Colombo", "estimation_unit": "points", "story_point_scale": "fibonacci", "default_assignee_rule": "reporter", "auto_transition_on_pr": true, "auto_transition_on_merge": true, "require_dor_for_sprint": false, "require_dod_for_done": true, "guest_can_comment": true, "ai_assist_enabled": true, "telegram_group_chat_id": "-1001234567890", "wip_limits": {}, "hidden_columns": [], "business_hours": { "start": "09:00", "end": "18:00" }, "auto_incident_on_down": true }}How it fails
RESOURCE_NOT_FOUNDunknown project_id, or a project outside the token's scope or the person's visibility.
FORBIDDENthe token belongs to a client guest, who may read the project but not its settings.
TOKEN_MISSING_ABILITYtoken lacks project:view.
How is this guide?
Last updated on