add_manhour_estimated_in_summary_mode
ChatGPTAdd an estimated manhour in summary mode for a specific issue.
Overview
ONES MCP Server connects Claude to ONES workspaces so teams can query and act on product development data with user-approved permissions. It supports projects, issues, issue fields, comments, worklogs, Wiki spaces and pages, account users, and test case libraries. Users can search, read, create, and update supported ONES records through natural language while keeping access scoped to the selected team and the authorizing user’s existing permissions.
Tools
add_workhour_in_simple_mode
ChatGPTAdd a manhour record in simple mode for a specific issue.
add_workhour_in_summary_mode
ChatGPTAdd a manhour record in summary mode for a specific issue.
create_module_in_testcase_library
ChatGPTCreate a new module in a test case library.
create_new_issue
ChatGPTCreate a new issue/task/bug/requirement/epic/release/etc. Prep: get_issue_types(projectID)+get_issue_fields(projectID,issueTypeID); required fieldValues; never set status. Hyperlink (field_type_uuid is hyperlink): Prefer constructing the final wiki URL directly; Do not ask whether to use the page title or link text. Use the runtime team_uuid. {web_base_url}/wiki/#/team/{team_uuid}/page/{page_id} or /wiki/#/team/{team_uuid}/page/{page_id}. Work hours: field018 is a deprecated estimated work-hours field; use field060 instead of field018. First try the simple create payload format for field060 [{"hours":100000,"mode":"simple","type":"estimated"}]. If fails needing detailed payload, retry create_new_issue ("hours_format":"sum","mode":"detailed"; owner is the current user UUID; default to as today's 23:59:59 timestamp; If estimated hours are <= 8, use that default to; else +90000000ms/8h). If field060 missing, ask then retry. field019/020=manhour tools. field002(=create_page md), never field016.
create_new_project
ChatGPTCreate a new project. The template can only be selected in this tool and cannot be changed after created by all means. If it's not clear, the members can be set to None or empty list, which means no members other than the creator. After created, the creator will be the owner of the project. Other members can be added later using add_project_members tool.
create_new_testcase_in_library
ChatGPTCreate a new test case in a test case library. Always call get_testcase_library_fields with the target libraryID before creating the test case. Built-in fields such as library, module, name, priority, type, assign, description and condition must use the top-level parameters of this tool instead of fieldValues. For fieldValues, use the field alias returned by get_testcase_library_fields. For date fields, prefer dateValue in YYYY-MM-DD format.
create_page
ChatGPTCreate a new page in a wiki space. The first line of the content should be the same as the title and using H1 markdown syntax. Supported markdown: CommonMark + GFM (headings, paragraphs, links, lists, single-level blockquote, tables, task lists, strikethrough), inline math, inline/fenced code (with language), <sup>/<sub>, mermaid/plantuml fenced blocks. Special one-line tags: - mention: <mention id="user_id">user_name</mention> (no self-closing) - status: <status color="blue|green|red|yellow|purple|grey">text</status> (text only, ≤10 chars; no self-closing) - callout: <callout type="info|warning|danger|success">...</callout> (inner markdown OK; no nested callout) - date: <date year="2023" month="10" day="12"></date> or <date .../> Unsupported: nested blockquotes, footnotes, definition lists, images. Hard break: two trailing spaces.
create_space
ChatGPTCreate a new wiki space (page group). Initializes the homepage, archive, recycle bin, notification settings, and default permissions. The caller must be allowed to create spaces and the team must have an available Wiki license. Returns space details including id and homePageID. Use homePageID as parentPageID in create_page to add pages under this space.
create_sprint
ChatGPTCreate a new sprint
execute_issue_workflow
ChatGPTExecute a workflow on a specific issue. This is the only valid way to update the issue state. Before executing a workflow, please make sure to get the executable workflows using tool
get_issue_executable_workflows. The issue's state can only be one of the valid target states defined in the executable workflows. If the issue is currently in a start state, it will transite to the end state after executing the workflow.find_similar_issues
ChatGPTFind similar issues based on the content of a specific issue. The issueID is required. The targetProjectID and targetIssueTypeID are all required. If not clear, ask the user to provide them. This tool will find issues that are similar in title plus description to the specified issue within the target project and issue type.
get_favorite_or_watch_pages
ChatGPTGet wiki pages that the current user is watching or favoriting.
get_issue_activities
ChatGPTGet a history of what happened to specific issues, including field values changes, comments, status changes, etc. The sinceDateTime parameter determines the lower bound of activities to retrieve. This tool call is rather expensive, so only call it when necessary, and pass no more than 5 issueIDs at a time. The result is a map of issueID to activities.
get_issue_code_info
ChatGPTGet code-related information for a specific issue, including linked commits, branches, and pull requests.
get_issue_details
ChatGPTGet details of a specific issue. estimateVariance is the hours variance of the estimate. It's calculated as estimated - (actual + remaining). Any attachments are returned as attachment metadata in the result. fieldValues may include object-link / dependency fields (field_type_uuid multi_task_link or single_task_link, e.g. predecessor/successor/related links); values are related issue IDs. Discover those field UUIDs via get_issue_fields when needed.
get_issue_executable_workflows
ChatGPTGet the executable workflows for a specific issue. Executable workflow is the only valid way to update the issue state. Each workflow contains the start state, end state, and the workflow ID.
get_issue_fields
ChatGPTGet issue fields (uuid, name, required, types). Branches: - issueTypeID + projectID: fields from that issue type's create/detail forms in the project, plus team object-link/dependency fields (multi_task_link/single_task_link). - issueTypeID only: fields from that issue type's team-level create/detail forms, plus team object-link/dependency fields. - projectID only: union of fields across all issue types in the project, deduplicated (browse permission), plus object-link fields. required is true if any type's create form requires it; can_be_created is always false in this aggregate view. - neither: team's full issue field library (requires project administration permission); no options; can_be_created=false. Team library required flags are not project/type form required rules. Object-link fields (field_type_uuid multi_task_link or single_task_link, e.g. predecessor/successor/related links) are the way to discover work-item association relation names and UUIDs; use them with get_issue_details fieldValues or query_issues_by_onesql. Do not confuse them with hierarchy fields (field014/field114/field037/field053). Cursor-paginated over fields: page size 50; check pageInfo.hasNextPage / pageInfo.endCursor / pageInfo.total. Per-field options remain capped at 30 when included (use search_for_issue_field_options for more). Prefer value_type_desc over deprecated type: text|multi_line_text; float/duration_hour=*100000; integer/duration_second=raw; single/multi_reference_object=ID(s); date="YYYY-MM-DD"; datetime="YYYY-MM-DD HH:mm:ss" for create/update. Hyperlink (field_type_uuid is hyperlink): Prefer constructing the final wiki URL directly; Do not ask whether to use the page title or link text. Use the runtime team_uuid. {web_base_url}/wiki/#/team/{team_uuid}/page/{page_id} or /wiki/#/team/{team_uuid}/page/{page_id}. Work hours: field018 is deprecated for estimated work hours—use field060. On create, first try the simple field060 payload format; if needed, retry create_new_issue with the detailed field060 payload format (see create_new_issue). For existing issues, estimated work hours still follow the dedicated manhour/workhour tool flow after get_manhour_mode. field019/020 manhour tools only.
get_issue_human_readable_keys
ChatGPTGet human-readable keys for a batch of issues. The response keeps the same input order and returns issueID/displayID pairs, where displayID is the issue's human-readable key.
get_issue_status
ChatGPTGet all issue statuses. If projectID is provided, only issue statuses associated with that project are returned. Returns a list of issue statuses, each containing: - id: The ID of the issue status. - name: The name of the issue status.
get_issue_type_hierarchy_configs
ChatGPTGet issue-type hierarchy configs. Each hierarchy: name; parent_field (parent→child IDs); children_field (child→parent ID); relation_type (one_to_many|many_to_many); issue_type_hierarchy_tree with issue_type_id, issue_type_name, children[]. To link parent/child, set parent_field on child or children_field on parent (one side enough; system keeps both sides consistent).
get_issue_types
ChatGPTGet issue types by optional name keyword. With projectID: returns project-associated issue types in project order (id, name, type, builtIn, issueTypeScopeID); requires project browse permission. Without projectID: returns the team issue type library sorted by name; requires project administration permission. If input is omitted or empty, return matching issue types in that scope. Cursor-paginated: page size 50; check pageInfo.hasNextPage / pageInfo.endCursor / pageInfo.total.
get_list_of_issue_comments
ChatGPTGet a list of comments for a specific issue. Each comment includes plain text in
text and markdown converted from embeds when present; prefer markdown when reading the comment body. Comments may include attachments when embeds/files are present. When attachments is present, treat each item as content to extract—not metadata only. Use fileName/fileType for context; prefer an item's summary when available as its extracted text; for images use base64 (data URI) when available. Do not rely only on attachment links in markdown/content when those payloads are present.get_list_of_space_pages
ChatGPTGet a list of pages in a specific wiki space(page group). Use this tool to retrieve the list of pages in a specific space by its ID. The result includes ID, title, parentID of each page and other metdata. The result contains pages hierechy information. Call this tool ONLY when you don't know how to search for a page by title OR you need the hierechy information. If you know the title keyword of the page you want to find, use the search_pages_by_title tool with spaceUUIDs parameter to limit the search scope to this space.
get_manhour_list_in_simple_mode
ChatGPTGet a list of manhour records in simple mode for a specific issue.
get_manhour_list_in_summary_mode
ChatGPTGet a list of manhour records in summary mode for a specific issue.
get_manhour_mode
ChatGPTget manhour mode (simple or summary) for current team. Always call this tool first before any other manhour related tools to determine the manhour mode. When manhour mode is 'simple', use simple mode tools. When manhour mode is 'summary', use summary mode tools.
get_onesql_grammar_help
ChatGPTGet help on the ONESQL grammar and usage rules for querying issues. This tool MUST be called before using the query_issues_by_onesql tool.
get_page_attachment_text
ChatGPTGet the text content(converted to text) of a specific attachment in a wiki page.
get_page_changes
ChatGPTGet the changes made to a specific wiki page since a given date-time. Returns the base version of all changes and changes(operations) grouped by user and ordered by time after the specified date-time (sinceDateTime). The returned changes include the base version of all the changes (in "data" field), the operations performed grouped by user and ordered by time (in "ops" field").
get_page_details
ChatGPTGet details of a specific page in a wiki space. Includes title, full content (markdown), comments, attachments, and metadata. When
attachments is present, treat each item as content to extract—not metadata only. Use fileName/fileType for context; prefer an item's summary when available as its extracted text; for images use base64 (data URI) when available. Do not rely only on attachment links in markdown/content when those payloads are present.get_project_details_by_project_id
ChatGPTGet project details by project ID.
get_project_members
ChatGPTGet project members grouped by role. Without roleID: overview of all roles, each capped at the first 50 member IDs; memberTotal is the full count per role; use roleID+cursor for the rest. With roleID: cursor-paginated members of that role (page size 50; pageInfo.hasNextPage / pageInfo.endCursor / pageInfo.total). The same user may appear under multiple roles. Requires member component view permission.
get_project_roles
ChatGPTGet project roles. With projectID: returns roles configured in the project (requires member component view permission). Without projectID: returns team-level project role definitions (requires project administration permission). Cursor-paginated: page size 50; check pageInfo.hasNextPage / pageInfo.endCursor / pageInfo.total.
get_space_details
ChatGPTGet details of a specific wiki space(page group). Use this tool to retrieve the details of a specific space by its ID. It's returns homePageID, which is the ID of the home page of the space. When you need to create a new page in root of the space, you can use this ID as the parentPageID in the create_page tool.
get_sprint_details
ChatGPTGet details of a specific sprint. The response includes the sprint built-in fields and custom fields.
get_testcase_details
ChatGPTGet details of a specific test case in a test case library.
get_testcase_library_fields
ChatGPTGet all fields configured in a test case library.
get_user_notices
ChatGPTGet user notices since a specific datetime in ISO 8601 format.
post_issue_comment
ChatGPTPost a comment on a specific issue. The comment can be used to notify users by mentioning them. To mention a user, include '@username' or '@user_id' in the comment text. Add spaces around the mention to ensure proper parsing. The full username or user ID (which can be retrieved using search_for_users tool) must be used for the mention to work correctly.
query_issues_by_onesql
ChatGPTQuery issues using ONESQL. ONESQL has its own grammar and usage rules. Before using this tool, get_onesql_grammar_help tool MUST be used to get the grammar and usage rules of ONESQL. This tool can be used instead of get_issue_details to query one or many issues with complex conditions and get fields' values flexibly.
read_attachment_content
ChatGPTRead attachment content by resourceID. Use this tool when another tool returns attachment's resourceID and you need attachment content for model reading. Important: - This tool returns attachment content to the model context; it does not save files to local working directories. - Supported outputs are text (utf-8 decode) and images. - Binary formats like video/audio/archive are not returned by this tool. In that case, tell the user this is a content-read tool, not a local file download tool, and suggest a different download path if local files are expected.
search_for_epics
ChatGPTSearch for epics by name keyword and optional project ID. If input is not provided, returns all epics accessible to the user. Max return 50 items, if cannot find the epic you want, please provide more specific keywords.
search_for_issue_field_options
ChatGPTSearch for options of a specific issue field based on a keyword. Normally the options are retrieved from get_issue_fields tool. But when there are too many options, only 30 options are returned by that tool. This tool can be used to search for more options. Or some options are not returned, you can also use this tool to search for the missing options. Max return 50 items, if cannot find the option you want, please try refining the keyword and try again. Some built-in fields that can be searched with this tool: - field029: product field. The options are the list of products can be associated with the issue. - field030: product module field. The options are the list of product modules that can be associated with the issue. Some other module-like fields use different tools: - field054: project module field. Use search_for_modules tool instead. (fields that are not listed above may or may not be searchable with this tool, please try and see if it works when necessary.)
search_for_modules
ChatGPTSearch for modules by name keyword and optional project ID. If input is not provided, returns all modules accessible to the user. Max return 50 items, if cannot find the module you want, please provide more specific keywords.
search_for_modules_in_testcase_library
ChatGPTSearch for modules in a test case library by name keyword. If input is not provided, returns modules accessible in the target library. Max return 200 items, if cannot find the module you want, please provide more specific keywords.
search_for_projects
ChatGPTSearch for projects by partial name and additional conditions. If input is not provided, returns all projects with applied conditions and accessible to the user. Max return 50 items, if cannot find the project you want, please provide more specific keywords.
search_for_references_in_wiki
ChatGPTSearch for references in ONES wiki using the original question and five expanded questions. When user ask questions that needs wiki knowledge/corporate knowledge, use this tool to search for references. Five expanded questions must be generated from the original question and provided to improve search results. Three of them are rephrased versions of the original question from different angles, One is a more general question (a step back version) of the original question, The last one is a possible answer to the original question. Use spaceIDs / pageIDs to limit the search scope to specific wiki spaces or pages when necessary. spaceIDs and pageIDs are mutually exclusive, only one of them can be provided at a time.
search_for_releases
ChatGPTSearch for releases (publish versions) by name keyword and optional project ID. If input is not provided, returns all releases accessible to the user. Max return 50 items, if cannot find the release you want, please provide more specific keywords.
search_for_spaces
ChatGPTSearch for wiki spaces by a keyword. This tool returns a list of wiki spaces that match the given keyword, including their ID, name, and other metadata. Returns 50 spaces at most. Refine your keyword if you need more specific results. If input is not provided, it returns the first 50 spaces in the team.
search_for_sprints
ChatGPTSearch for sprints by name keyword and optional project ID. If input is not provided, returns all sprints accessible to the user. Max return 50 items, if cannot find the sprint you want, please provide more specific keywords.
search_for_testcase_libraries
ChatGPTSearch for test case libraries by partial name and additional conditions. If input is not provided, returns all test case libraries accessible to the user. Max return 50 items, if cannot find the library you want, please provide more specific keywords.
search_for_testcases_in_library
ChatGPTSearch for test cases in a test case library by name keyword. If input is not provided, returns test cases accessible in the target library. Max return 50 items, if cannot find the test case you want, please provide more specific keywords.
search_for_users
ChatGPTSearch for users based on a keyword. This can be used to find users by their name, email or staff number. Returns user's ID, name, email
search_pages_by_title
ChatGPTSearch for pages by title keyword. When spaceUUIDs is provided, the search will be limited to the specified wiki spaces. SpaceUUIDs can be left empty to search across all spaces. This tool returns a list of pages that match the title keyword, including their ID, title, and other metadata.
set_manhour_estimated_in_simple_mode
ChatGPTSet the estimated manhour in simple mode for a specific issue.
set_manhour_remaining_in_simple_mode
ChatGPTSet the remaining manhour in simple mode for a specific issue.
update_issue
ChatGPTUpdate a issue. Only provided fields are updated. Respect get_issue_fields rules. Hyperlink (field_type_uuid is hyperlink): Prefer constructing the final wiki URL directly; Do not ask the user whether to use the page title or link text. Use the runtime team_uuid. {web_base_url}/wiki/#/team/{team_uuid}/page/{page_id} or /wiki/#/team/{team_uuid}/page/{page_id}. Work hours: field018 is a deprecated estimated work-hours field. Use field060 instead of field018. For existing issues, updating estimated work hours should follow the dedicated manhour/workhour flow (get_manhour_mode then dedicated tools). field019/020 use dedicated manhour/workhour tools for the current mode.
update_issue_comment
ChatGPTUpdate(modify) a comment on a specific issue. The comment can be used to notify users by mentioning them.
update_manhour_estimated_in_summary_mode
ChatGPTUpdate an estimated manhour in summary mode for a specific issue.
update_module_in_testcase_library
ChatGPTUpdate the name of a module in a test case library.
update_project_by_project_id
ChatGPTUpdate project basic information by project ID. Only the fields that's values are provided will be updated.
update_sprint
ChatGPTUpdate an existing sprint
update_testcase
ChatGPTUpdate a test case in a test case library. Only the provided top-level fields and fieldValues will be updated. When updating custom fields, always call get_testcase_library_fields with the target libraryID first. Built-in fields such as library, module, name, priority, type, assign, description and condition must use the top-level parameters of this tool instead of fieldValues. For fieldValues, use the field alias returned by get_testcase_library_fields. For date fields, prefer dateValue in YYYY-MM-DD format.
update_workhour_in_simple_mode
ChatGPTUpdate a manhour record in simple mode for a specific issue.
update_workhour_in_summary_mode
ChatGPTUpdate a manhour record in summary mode for a specific issue.
who_am_i
ChatGPTGet information about the current user used by all the tools to access the system. This can also be used to determine the user's time zone offset when constructing ISO 8601 datetime values.
add_manhour_estimated_in_summary_mode
Claudeadd_project_members
Claudeadd_workhour_in_simple_mode
Claudeadd_workhour_in_summary_mode
Claudecreate_module_in_testcase_library
Claudecreate_new_issue
Claudecreate_new_project
Claudecreate_new_testcase_in_library
Claudecreate_page
Claudecreate_sprint
Claudeexecute_issue_workflow
Claudefind_similar_issues
Claudeget_favorite_or_watch_pages
Claudeget_issue_activities
Claudeget_issue_code_info
Claudeget_issue_details
Claudeget_issue_executable_workflows
Claudeget_issue_fields
Claudeget_issue_human_readable_keys
Claudeget_issue_status
Claudeget_issue_type_hierarchy_configs
Claudeget_list_of_issue_comments
Claudeget_list_of_space_pages
Claudeget_manhour_list_in_simple_mode
Claudeget_manhour_list_in_summary_mode
Claudeget_manhour_mode
Claudeget_onesql_grammar_help
Claudeget_page_attachment_text
Claudeget_page_changes
Claudeget_page_details
Claudeget_project_details_by_project_id
Claudeget_space_details
Claudeget_sprint_details
Claudeget_testcase_details
Claudeget_testcase_library_fields
Claudeget_user_notices
Claudepost_issue_comment
Claudequery_issues_by_onesql
Clauderead_attachment_content
Claudesearch_for_epics
Claudesearch_for_issue_field_options
Claudesearch_for_issue_types
Claudesearch_for_modules
Claudesearch_for_modules_in_testcase_library
Claudesearch_for_projects
Claudesearch_for_references_in_wiki
Claudesearch_for_releases
Claudesearch_for_spaces
Claudesearch_for_sprints
Claudesearch_for_testcase_libraries
Claudesearch_for_testcases_in_library
Claudesearch_for_users
Claudesearch_pages_by_title
Claudeset_manhour_estimated_in_simple_mode
Claudeset_manhour_remaining_in_simple_mode
Claudeupdate_issue
Claudeupdate_issue_comment
Claudeupdate_manhour_estimated_in_summary_mode
Claudeupdate_module_in_testcase_library
Claudeupdate_project_by_project_id
Claudeupdate_sprint
Claudeupdate_testcase
Claudeupdate_workhour_in_simple_mode
Claudeupdate_workhour_in_summary_mode
Claudewho_am_i
ClaudeCapabilities
Writes
Example Prompts
Click any prompt to copy it.
