convert_to_subtask
ChatGPTUse this tool whenever you need to create or update a hierarchical relationship between existing tasks (task -> subtask). It converts one existing task into a subtask of another existing task.
create_task
ChatGPTCreate exactly one Runrun.it task on a specific board. Never use this tool for multiple tasks; for 2 or more tasks, use create_tasks in a single call.
create_tasks
ChatGPTPreferred task creation tool. Use this tool to create one or multiple tasks in a single call and optionally define a subtask hierarchy between them using parent_index. type_id is optional: if omitted, default enterprise task type is used.
get_board_stages
ChatGPTGet Runrun.it board stages from a specific board.
get_boards
ChatGPTGet Runrun.it boards the current user can access.
get_projects
ChatGPTGet Runrun.it projects the current user can access.
get_tags
ChatGPTGet a Runrun.it tags based on a natural language name or partial name.
get_task_types
ChatGPTGet Runrun.it task types the current user can access.
move_task
ChatGPTUse this tool to move an existing Runrun.it task to a different board stage and/or position. You MUST resolve board_stage_id with get_board_stages before calling this tool, UNLESS you want to move the task to another board without choosing a specific stage: in that case pass board_id alone and the task will be moved to the first opened stage of that board. At least one of board_stage_id, board_id or board_stage_position must be provided.
runrunit_add_task_assignee
ChatGPTAdd ONE assignee to a Runrun.it task, keeping all current assignees. This tool never removes nor replaces assignees. You MUST first resolve user_id with runrunit_get_users: user_id is the user slug, never a name or email. If more than one user matches the requested person, ask the user which one instead of choosing. Calling it again is safe: when the person is already an assignee nothing changes and already_assigned is true in the result; the team of an existing assignment is never changed. When the person lacks access to the task board, type, project or is not a partner, do not retry: tell the user, and the error says whether you, as performer, could grant the access in Runrun.it. The result lists every assignee of the task after the change.
runrunit_claim_task
ChatGPTClaim a Runrun.it task for the current user (take it, assign it to me, pull the next task of the queue), optionally moving it to a destination board stage in the same all-or-nothing operation: if anything fails, nothing is assigned and nothing is moved. The current user is added as assignee and existing assignees are kept; to assign somebody else use runrunit_add_task_assignee. To also move the task, resolve destination_board_stage_id with runrunit_get_board_stages (opened stages only); omit it to only claim the task. Calling it again is safe: when the user is already an assignee no assignment changes and already_assigned is true. The result lists the task after the change, whether it was moved and all assignees.
runrunit_complete_task_attachment_upload
ChatGPTStep 3 of 3 to attach a file to a Runrun.it task: checks the file uploaded to the URL returned by runrunit_create_task_attachment_upload and attaches it to the task. The file is available on the task only after this tool succeeds. Call it once the HTTP upload finished successfully. Calling it again is safe: an upload already attached is never duplicated and already_completed is true. When the error says the upload is incomplete, finish the upload before the URL expires and call it again; when the URL expired, start over with runrunit_create_task_attachment_upload. If the stored file is not the declared size it is deleted from the storage.
runrunit_convert_to_subtask
ChatGPTUse this tool whenever you need to create or update a hierarchical relationship between existing tasks (task -> subtask). It converts one existing task into a subtask of another existing task.
runrunit_create_task
ChatGPTCreate exactly one Runrun.it task on a specific board. Never use this tool for multiple tasks; for 2 or more tasks, use runrunit_create_tasks in a single call. Resolve board_id with runrunit_get_boards, type_id with runrunit_get_task_types, board_stage_id with runrunit_get_board_stages (stage_group: opened), and project_id with runrunit_get_projects (is_closed: false) before calling this tool.
runrunit_create_task_attachment_upload
ChatGPTStep 1 of 3 to attach a file to a Runrun.it task. Prepares a direct upload to the storage and returns a temporary signed URL with the HTTP method and headers to use. Requires reading the file and sending an HTTP request outside MCP (e.g. a shell with openssl and curl); if you cannot do both, do not call it and tell the user that attaching files needs such a client. Before calling it, compute the file size in bytes and its base64-encoded MD5 digest (e.g. openssl md5 -binary <file> | base64). Step 2: send the raw file bytes in a SEPARATE HTTP request, outside this MCP server, e.g. curl -X PUT -H "Content-Type: <header value>" --upload-file <file> "<url>", sending exactly the returned headers and nothing else, before expires_at. Step 3: call runrunit_complete_task_attachment_upload with the upload_id; the file is attached only then. Never send the file content or base64 through MCP tools. The URL and headers are temporary secrets: never write them in comments, descriptions or tasks. If the URL expires or the upload fails, call this tool again to get a new upload_id. Each call prepares a new upload.
runrunit_create_tasks
ChatGPTPreferred task creation tool. Use this tool to create one or multiple tasks in a single call and optionally define a subtask hierarchy between them using parent_index. type_id is optional: if omitted, default enterprise task type is used. Resolve board_id with runrunit_get_boards, type_id with runrunit_get_task_types, board_stage_id with runrunit_get_board_stages (stage_group: opened), and project_id with runrunit_get_projects (is_closed: false) before calling this tool.
runrunit_download_task_attachment
ChatGPTGet a download link for one attachment (file) of a Runrun.it task. Use runrunit_list_task_attachments first to get the attachment_id. Returns the attachment metadata (same fields as runrunit_list_task_attachments) and download_url: a short-lived signed link that expires at expires_at, or, when link_type is external, the link to the file on an external provider (Google Drive, Dropbox, etc.), subject to that provider's permissions. The file content itself is not returned: fetch download_url only when you need the content. Treat download_url as a secret: never write it into task comments, descriptions or other messages, and call this tool again when the link expires.
runrunit_get_board_overview
ChatGPTGet an overview of a Runrun.it board: its stages in order (opened stages first, then closed ones, each group by position) with the number of tasks, points and SLA overdue tasks in each stage, plus board totals. Counts consider only tasks visible to the current user. No tasks are returned: to list the tasks of a stage, use runrunit_search_tasks with board_stage_id. Use runrunit_get_boards to resolve the board ID.
runrunit_get_board_stages
ChatGPTGet Runrun.it board stages from a specific board, ordered by stage group (opened first, then closed) and by position. The result may be paginated: when next_after_id is present, call the tool again passing it in after_id to get the next page; when next_before_id is present, call the tool again passing it in before_id to get the previous page.
runrunit_get_boards
ChatGPTGet Runrun.it boards the current user can access. The result may be paginated: when next_after_id is present, call the tool again passing it in after_id to get the next page; when next_before_id is present, call the tool again passing it in before_id to get the previous page.
runrunit_get_clients
ChatGPTGet Runrun.it clients the current user can access, optionally filtered by a search term matched against the client name. Use this tool to resolve a client (e.g. to disambiguate projects). The result may be paginated: when next_after_id is present, call the tool again passing it in after_id to get the next page; when next_before_id is present, call the tool again passing it in before_id to get the previous page.
runrunit_get_current_user
ChatGPTReturns the identity, active company, timezone, roles and capabilities of the authenticated user. Call this tool at the start of a session to establish who you are acting as, which company you are operating in and what actions are permitted — do not infer this from other context.
runrunit_get_notification
ChatGPTGet the details of a single notification from the current user's Runrun.it inbox. Use it after runrunit_list_notifications to understand what happened and which entity it refers to. The references field tells which tools can be called next for the target. This tool never marks the notification as read.
runrunit_get_project_groups
ChatGPTGet Runrun.it project groups the current user can access, optionally filtered by client and/or a search term matched against the group name. Use this tool to resolve a project group (e.g. to disambiguate projects with the same name). Resolve client_id with runrunit_get_clients before calling this tool (optional filter). The result may be paginated: when next_after_id is present, call the tool again passing it in after_id to get the next page; when next_before_id is present, call the tool again passing it in before_id to get the previous page.
runrunit_get_project_subgroups
ChatGPTGet Runrun.it project subgroups from a specific project group, optionally filtered by a search term matched against the subgroup name. Use this tool to resolve a project subgroup (e.g. to disambiguate projects with the same name). Resolve project_group_id with runrunit_get_project_groups before calling this tool. The result may be paginated: when next_after_id is present, call the tool again passing it in after_id to get the next page; when next_before_id is present, call the tool again passing it in before_id to get the previous page.
runrunit_get_projects
ChatGPTGet Runrun.it projects the current user can access. The result may be paginated: when next_after_id is present, call the tool again passing it in after_id to get the next page; when next_before_id is present, call the tool again passing it in before_id to get the previous page.
runrunit_get_tags
ChatGPTGet Runrun.it tags based on a natural language name or partial name. The result may be paginated: when next_after_name is present, call the tool again passing it in after_name to get the next page; when next_before_name is present, call the tool again passing it in before_name to get the previous page.
runrunit_get_task
ChatGPTGet the details of a single Runrun.it task by its numeric ID. Use this tool when you already know the task ID (e.g. from runrunit_search_tasks or runrunit_create_task) and need its current board, board stage, project and position. Use runrunit_get_task_description instead when you need the task description content.
runrunit_get_task_description
ChatGPTGet the description of a single Runrun.it task by its numeric ID. Returns the description as raw HTML (description_html) and as plain text (description_text). Use this tool when you need the description content of a task; use runrunit_get_task instead when you only need board, board stage, project or position details.
runrunit_get_task_fields
ChatGPTList the custom fields of the board of a Runrun.it task, with the current value of each one, its rules, whether the current user can change it and, for choice fields with up to 30 options, the options. Use it before runrunit_update_task_custom_field to get field_id and the expected value format. Document fields are not listed.
runrunit_get_task_types
ChatGPTGet Runrun.it task types the current user can access. The result may be paginated: when next_after_id is present, call the tool again passing it in after_id to get the next page; when next_before_id is present, call the tool again passing it in before_id to get the previous page.
runrunit_get_users
ChatGPTGet Runrun.it users the current user can access, optionally filtered by a search term matched against user name or email. Use this tool to resolve a user (e.g. task assignee) by name or email. Each user is identified by its public slug in the id field (a string, not a numeric ID); use that slug to refer to a user. The result may be paginated: when next_after_slug is present, call the tool again passing it in after_slug to get the next page; when next_before_slug is present, call the tool again passing it in before_slug to get the previous page.
runrunit_list_notifications
ChatGPTList the notifications of the current user's Runrun.it inbox, newest first. Use it to review mentions, comments, assignments, task updates, due date alerts and task emails that need attention. Call runrunit_get_notification with an id to read a notification in full and get the tools to follow up on it. This tool never marks notifications as read. Paginate with cursor: when has_more is true, call again passing next_cursor in cursor.
runrunit_list_task_attachments
ChatGPTList the attachments (files) of a Runrun.it task that the current user can see, with their metadata: id, name, MIME type, size in bytes, extension, kind, upload date and uploader. It returns only metadata: no file content and no download link. Results come in pages of up to 50 attachments, ordered by ascending ID. When next_after_id is not null, the list is incomplete: call the tool again passing next_after_id in after_id to get the next page. When next_before_id is not null, pass it in before_id to get the previous page.
runrunit_list_tasks
ChatGPTList Runrun.it tasks by structured filters, page by page, to plan the day or find available work: boards, board stages, assignee (me or unassigned), urgency, overdue, projects, task types, tags, a date range and state. Combined filters narrow the result (AND); a list filter matches any of its values, except tags, which must all be on the task. Do not use it to find tasks by words in their title or description: use runrunit_search_tasks. Each task brings only a summary (id, title, url, board, stage, project, type, urgency, due date, overdue and assignees or assigned teams, plus creation and closing dates); there are no descriptions, comments or history: call runrunit_get_task with the id for the details. Resolve ids before filtering: board_ids with runrunit_get_boards, board_stage_ids with runrunit_get_board_stages, project_ids with runrunit_get_projects and task_type_ids with runrunit_get_task_types; tags are filtered by name, so pass the names directly. By default lists open tasks, due date first (tasks without due date last), 20 per page (max 50). Runrun.it has no cancelled state: state closed lists every closed (delivered) task. The result is paginated: when has_more is true, call the tool again with next_after_cursor in after_cursor (or next_before_cursor in before_cursor to go back) and the same filters and sort. Cursors are opaque and only work with the same filters and sort; when one is rejected, start again without cursor. Pages are not a snapshot: a task changed between calls may be skipped or listed again, and a cursor is rejected when the last task of its page no longer matches the filters. Prefer narrower filters to reading many pages.
runrunit_mark_notifications_as_read
ChatGPTMark the given notifications of the current user's Runrun.it inbox as read. Only call it when the user explicitly wants the notifications marked as read: runrunit_list_notifications and runrunit_get_notification never change the read state. The operation is idempotent and the batch is partial: valid notifications are marked even when other IDs fail.
runrunit_move_task
ChatGPTUse this tool to move an existing Runrun.it task to a different board stage and/or position. You MUST resolve board_stage_id with runrunit_get_board_stages before calling this tool, UNLESS you want to move the task to another board without choosing a specific stage: in that case pass board_id alone and the task will be moved to the first opened stage of that board. At least one of board_stage_id, board_id or board_stage_position must be provided.
runrunit_remove_task_assignee
ChatGPTRemove a single assignee from a Runrun.it task. Only the given person is unassigned: the other assignees and the other task fields are kept. You MUST resolve assignee_id with runrunit_get_users (the user slug, never the display name). If the person is not assigned to the task, nothing changes and the result has removed: false, so it is safe to retry. Removing the last assignee is allowed and leaves the task without assignees (task_unassigned: true). Tasks with a sequence of responsibles (workflow) and closed tasks cannot have assignees removed. The hours the person worked on the task are kept.
runrunit_search_custom_field_options
ChatGPTSearch the options of a choice custom field (single_option or multiple_options) on the board of a Runrun.it task. Use it when runrunit_get_task_fields returns options: null for the field. The returned id is the value to send to runrunit_update_task_custom_field. With search_term, returns up to 20 candidate options, without pagination: it combines similar meaning, similar spelling and the term inside the label ignoring case, accents and punctuation (e.g. "1234560001" finds "123.456/0001"). Candidates are not exact matches: compare each label with what the user asked for, and ask the user when none or more than one fits. Without search_term, all options are listed in the field's order and the result may be paginated: when next_after_id is present, call the tool again passing it in after_id to get the next page; when next_before_id is present, call the tool again passing it in before_id to get the previous page.
runrunit_search_tasks
ChatGPTSearch for tasks by a search term applied over data. The maximum number of tasks returned is 20. Resolve board_id with runrunit_get_boards and board_stage_id with runrunit_get_board_stages before calling this tool.
runrunit_update_task_custom_field
ChatGPTChange the value of one custom field of an existing Runrun.it task, or clear it by passing value: null. You MUST call runrunit_get_task_fields first to get field_id, the field type and its rules; for choice fields without listed options, get option IDs with runrunit_search_custom_field_options. Never invent IDs. Value format by field type: short_text, long_text and email take a string; numeric takes a number; rating takes an integer from 1 to details.max_rating; date takes "YYYY-MM-DD"; datetime takes an ISO 8601 date-time (e.g. "2026-11-12T14:30:00-03:00"); single_option takes one option ID; multiple_options takes an array of option IDs that replaces the whole selection (include the current ones to keep them; repeated IDs are ignored). Long text values replace the whole text: read the full current text with runrunit_get_task_fields before appending to it. Calling it with the current value is safe: nothing changes and already_had_value is true. The change follows the same rules as the task page in the web app: the field must be on the task's board and active, the user must be able to edit the task, and the board may restrict who edits the field. Document fields cannot be changed with this tool. When a rule or the value format is not met, an error explains why and nothing is changed. Do not call it for a field with is_value_editable: false. When the requested value does not fit the field (e.g. 4.5 in a rating field or more decimal places than details.precision), ask the user which value to use instead of rounding it yourself, and do not write the value in another field (e.g. a text field) on your own.
runrunit_update_task_description
ChatGPTReplace the description of an existing Runrun.it task by its numeric ID. The description must be sent as raw HTML (e.g. "<p>text</p>"). Do NOT HTML-escape the tags (e.g. do not send "<p>"); send literal "<" and ">" characters. This tool replaces the whole description: it does not append nor patch the existing content. If the task description is currently being edited by another user in the web app, the update is rejected and an error message is returned.
runrunit_update_task_points
ChatGPTChange the points (Scrum score) of an existing Runrun.it task. Send the new value as an integer (e.g. 5), or null to remove the points. It only works when the company uses points ("Enable Scrum score" in the task settings). An invalid value is rejected and nothing is changed. The result has the task and its points after the change.
runrunit_update_task_tags
ChatGPTReplace the whole list of tags of an existing Runrun.it task. Send in tags the name of every tag the task must have (e.g. ["backend", "urgent"]): tags left out are removed, and [] removes all tags. To add or remove a single tag, get the current tags with runrunit_get_task and send the full list. Reuse the exact name of an existing tag found with runrunit_get_tags (search_term); a name that does not exist yet creates a new tag. An invalid value is rejected and nothing is changed. The result has the task and its tags after the change.
runrunit_update_task_title
ChatGPTReplace the title of an existing Runrun.it task by its numeric ID. Send the final, complete title: this tool replaces the whole title, it does not append nor patch it. It changes only the title and never touches any other task field. To change the description, use runrunit_update_task_description instead. The change follows the same permissions as the web app: if the user cannot edit the title of the task, an error explains why and nothing is changed.
search_tasks
ChatGPTSearch for tasks by a search term applied over data.The maximum number of tasks returned is 20.