MCP App Store
by KeenEthics
Runrun.it icon

Runrun.it MCP Server for ChatGPT

By Runrun.it

Overview

Connect ChatGPT to your Runrun.it workspace to manage work without leaving the conversation. This app lets you quickly create one or multiple tasks and search existing tasks, using your actual Runrun.it data and permissions. It also helps you add the right context by letting you browse boards, stages, task types, projects, and tags before creating tasks—so what you create is already organized the way your team works. Great for turning ideas into tasks, and finding the status of work fast.

How to connect

  1. ChatGPT: Open the Runrun.it listing in the ChatGPT app directory and choose Connect. ChatGPT listing Runrun.it exposes 39 tools here.

Tools

convert_to_subtask

ChatGPT
Use 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

ChatGPT
Create 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

ChatGPT
Preferred 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

ChatGPT
Get Runrun.it board stages from a specific board.

get_boards

ChatGPT
Get Runrun.it boards the current user can access.

get_projects

ChatGPT
Get Runrun.it projects the current user can access.

get_tags

ChatGPT
Get a Runrun.it tags based on a natural language name or partial name.

get_task_types

ChatGPT
Get Runrun.it task types the current user can access.

move_task

ChatGPT
Use 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

ChatGPT
Add 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

ChatGPT
Claim 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

ChatGPT
Step 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

ChatGPT
Use 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

ChatGPT
Create 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

ChatGPT
Step 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_task_comment

ChatGPT
Publish a comment on a Runrun.it task, or reply to an existing comment of that task (e.g. to answer a mention). To reply, send reply_to_comment_id: the reply joins the same thread and channel as the original comment. Without reply_to_comment_id, a new thread is started on the internal channel. MENTIONS: writing "@Name" or "#123" as plain text does NOT mention or notify anyone. To mention a user, you MUST first call runrunit_get_users to get the user id (slug), then write <mention>@user_id</mention> (e.g. <mention>@ana-souza</mention>); the user is notified. If the user cannot be found, ask instead of publishing. To reference a task, write <mention>#task_id</mention> with the numeric task ID (e.g. <mention>#181347</mention>). After publishing, check unrecognized_mentions in the result: those mentions did not work and nobody was notified, so tell the user instead of saying the mention succeeded. FORMATTING: write plain text; the only HTML tags kept are <b>, <i>, <u> and <mention>, any other tag is removed. For line breaks, insert real new lines in the text instead of tags like <p> or <br>. Each call creates a new comment, so do not retry a successful call.

runrunit_create_tasks

ChatGPT
Preferred 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Returns 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
Get 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

ChatGPT
List 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

ChatGPT
Get 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

ChatGPT
Get 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_comment_replies

ChatGPT
List the replies of a single comment thread of a Runrun.it task, page by page. Use it when runrunit_list_task_comments returns a comment with reply_count greater than 0 and the discussion is relevant: pass that comment id in comment_id (a reply id also works, its whole thread is listed). Each reply brings reply_to_comment_id, the comment it answers inside the thread. By default returns the oldest replies first (order: oldest_first), 20 per page, with the concise response_format (content truncated to 500 characters, flagged by content_truncated), which already brings author_id; use response_format: detailed only to read in full a reply with content_truncated: true. The result is paginated: when has_more is true, call the tool again passing next_cursor in cursor to get the next page; pass prev_cursor in cursor to go back. Keep the same order between pages. Use runrunit_create_task_comment with reply_to_comment_id to answer in the thread.

runrunit_list_notifications

ChatGPT
List 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

ChatGPT
List 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_task_comments

ChatGPT
List the comments of a Runrun.it task, page by page, to understand its progress and recent conversation. By default returns the newest comments first (order: newest_first), 20 per page, from every channel the user can access, only with comments written by people: AI agent comments and automatic system events (status changes, automations, etc.) are listed only with include_system_events. Only top-level comments are listed: replies are not expanded, each comment brings reply_count and latest_reply_at instead; call runrunit_list_comment_replies with its id to read the replies of a thread. Listed comments are independent: a top-level comment never replies to the previous one, replies exist only inside each comment thread. When the user asks about replies, answers or how a conversation went on, call runrunit_list_comment_replies for the comments with reply_count > 0 before answering. Keep the default concise response_format: it brings every field, including author_id and thread_id, with the content truncated to 500 characters (flagged by content_truncated); use response_format: detailed only to read in full a comment with content_truncated: true. total_count is the number of comments that match the filters across all pages; use it to report how many comments there are, never the size of a page. The result is paginated: when has_more is true, call the tool again passing next_cursor in cursor to get the next (older, for newest_first) page; pass prev_cursor in cursor to go back. Keep the same filters and order between pages. To know the recent activity or what is happening on the task, keep order: newest_first; with oldest_first and has_more: true, the newest comments are not on the page. Use runrunit_get_task_description for the task description and runrunit_create_task_comment to reply.

runrunit_list_tasks

ChatGPT
List 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

ChatGPT
Mark 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

ChatGPT
Use 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

ChatGPT
Remove 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

ChatGPT
Search 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

ChatGPT
Search 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

ChatGPT
Change 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

ChatGPT
Replace 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 "&lt;p&gt;"); 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

ChatGPT
Change 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

ChatGPT
Replace 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

ChatGPT
Replace 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

ChatGPT
Search for tasks by a search term applied over data.The maximum number of tasks returned is 20.

Capabilities

Writes

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/runrun-it"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/runrun-it)