[Bug]: Unable to update custom checklist field (Definition of Done) via Jira REST API #722
Description
Prerequisites
- I have searched the existing issues to make sure this bug has not already been reported.
- I have checked the README for relevant information.
Bug Description
I'm experiencing an issue when trying to update a custom checklist field (Definition of Done) using the Jira REST API through the mcp-atlassian tool.
Field Details:
Field ID: customfield_11003
Field Name: "Definition of Done"
Field Type: com.okapya.jira.checklist:checklist
Custom ID: 11003
Expected Behavior: Should be able to update the checklist field with an array of strings, similar to how it works for other issues.
Actual Behavior: Getting an error when attempting to update the field using the update_issue function.
Working Example (FDM-2349): the agent can read the field from other stories but trying to update with the same format fails:
Failed Update Attempt (FDM-2364): Trying to update with the same format fails:
{
"customfield_11003": [
"Custom service account created for Dataform workflows",
"All affected workflows updated to use custom SA or Google Account",
"No workflow uses Dataform service agent",
"Documentation updated for new access control model",
"Tested and validated workflow execution under new model"
]
}
Question: Is there a specific format or additional parameters required for updating checklist fields? Or could this be a permissions issue specific to certain projects/issues?
Steps to Reproduce
Setup: Use mcp-atlassian tool with valid Jira credentials
Read working example:
Result: Successfully returns checklist data in format:
Attempt to update similar field:
Observe error: Update operation fails with error
Additional Context:
Both issues (FDM-2349 and FDM-2364) are in the same project (FDM)
Both have the same custom field (Definition of Done - customfield_11003)
Same user credentials used for both read and write operations
Other standard fields (priority, description) update successfully on FDM-2364
Expected Behavior
It should be able to update the field.
Actual Behavior
receive error:
2025-10-08 12:07:27.507 [warning] [server stderr] ERROR - mcp-jira - Error updating issue FDM-2364: Internal server error
2025-10-08 12:07:27.507 [warning] [server stderr] ERROR - mcp_atlassian.servers.jira - Error updating issue FDM-2364: Failed to update issue FDM-2364: Internal server error
2025-10-08 12:07:27.508 [warning] [server stderr] Traceback (most recent call last):
2025-10-08 12:07:27.508 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/mcp_atlassian/jira/issues.py", line 1058, in update_issue
2025-10-08 12:07:27.508 [warning] [server stderr] self.jira.update_issue(
2025-10-08 12:07:27.508 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/atlassian/jira.py", line 1479, in update_issue
2025-10-08 12:07:27.508 [warning] [server stderr] return self.put(endpoint, data=update)
2025-10-08 12:07:27.508 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/atlassian/rest_client.py", line 812, in put
2025-10-08 12:07:27.509 [warning] [server stderr] response = self.request(
2025-10-08 12:07:27.509 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/atlassian/rest_client.py", line 445, in request
2025-10-08 12:07:27.509 [warning] [server stderr] self.raise_for_status(response)
2025-10-08 12:07:27.509 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/atlassian/rest_client.py", line 994, in raise_for_status
2025-10-08 12:07:27.509 [warning] [server stderr] raise HTTPError(error_msg, response=response)
2025-10-08 12:07:27.509 [warning] [server stderr] requests.exceptions.HTTPError: Internal server error
2025-10-08 12:07:27.510 [warning] [server stderr]
2025-10-08 12:07:27.510 [warning] [server stderr] The above exception was the direct cause of the following exception:
2025-10-08 12:07:27.510 [warning] [server stderr]
2025-10-08 12:07:27.510 [warning] [server stderr] Traceback (most recent call last):
2025-10-08 12:07:27.510 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/mcp_atlassian/servers/jira.py", line 940, in update_issue
2025-10-08 12:07:27.510 [warning] [server stderr] issue = jira.update_issue(issue_key=issue_key, **all_updates)
2025-10-08 12:07:27.510 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/mcp_atlassian/jira/issues.py", line 1094, in update_issue
2025-10-08 12:07:27.511 [warning] [server stderr] raise ValueError(f"Failed to update issue {issue_key}: {error_msg}") from e
2025-10-08 12:07:27.511 [warning] [server stderr] ValueError: Failed to update issue FDM-2364: Internal server error
2025-10-08 12:07:28.026 [warning] [server stderr] [10/08/25 10:07:27] ERROR Error calling tool tool_manager.py:129
2025-10-08 12:07:28.026 [warning] [server stderr] 'update_issue': Failed to
2025-10-08 12:07:28.026 [warning] [server stderr] update issue FDM-2364: Failed
2025-10-08 12:07:28.027 [warning] [server stderr] to update issue FDM-2364:
2025-10-08 12:07:28.027 [warning] [server stderr] Internal server error
2025-10-08 12:07:28.027 [warning] [server stderr] ╭─ Traceback (most recent cal─╮
2025-10-08 12:07:28.027 [warning] [server stderr] │ /app/.venv/lib/python3.10/s │
2025-10-08 12:07:28.027 [warning] [server stderr] │ ite-packages/mcp_atlassian/ │
2025-10-08 12:07:28.027 [warning] [server stderr] │ jira/issues.py:1058 in │
2025-10-08 12:07:28.027 [warning] [server stderr] │ update_issue │
2025-10-08 12:07:28.028 [warning] [server stderr] │ │
2025-10-08 12:07:28.028 [warning] [server stderr] │ 1055 │ │ │ │
2025-10-08 12:07:28.028 [warning] [server stderr] │ 1056 │ │ │ # Update │
2025-10-08 12:07:28.028 [warning] [server stderr] │ 1057 │ │ │ if updat │
2025-10-08 12:07:28.028 [warning] [server stderr] │ ❱ 1058 │ │ │ │ self │
2025-10-08 12:07:28.028 [warning] [server stderr] │ 1059 │ │ │ │ │ │
2025-10-08 12:07:28.028 [warning] [server stderr] │ 1060 │ │ │ │ ) │
2025-10-08 12:07:28.028 [warning] [server stderr] │ 1061 │
2025-10-08 12:07:28.028 [warning] [server stderr] │ │
2025-10-08 12:07:28.028 [warning] [server stderr] │ /app/.venv/lib/python3.10/s │
2025-10-08 12:07:28.028 [warning] [server stderr] │ ite-packages/atlassian/jira │
2025-10-08 12:07:28.029 [warning] [server stderr] │ .py:1479 in update_issue │
2025-10-08 12:07:28.029 [warning] [server stderr] │ │
2025-10-08 12:07:28.029 [warning] [server stderr] │ 1476 │ │ :return: Tru │
2025-10-08 12:07:28.029 [warning] [server stderr] │ 1477 │ │ """ │
2025-10-08 12:07:28.029 [warning] [server stderr] │ 1478 │ │ endpoint = f │
2025-10-08 12:07:28.029 [warning] [server stderr] │ ❱ 1479 │ │ return self. │
2025-10-08 12:07:28.029 [warning] [server stderr] │ 1480 │ │
2025-10-08 12:07:28.029 [warning] [server stderr] │ 1481 │ def label_issue( │
2025-10-08 12:07:28.029 [warning] [server stderr] │ 1482 │ │ """ │
2025-10-08 12:07:28.029 [warning] [server stderr] │ │
2025-10-08 12:07:28.030 [warning] [server stderr] │ /app/.venv/lib/python3.10/s │
2025-10-08 12:07:28.030 [warning] [server stderr] │ ite-packages/atlassian/rest │
2025-10-08 12:07:28.030 [warning] [server stderr] │ _client.py:812 in put │
2025-10-08 12:07:28.030 [warning] [server stderr] │ │
2025-10-08 12:07:28.030 [warning] [server stderr] │ 809 │ │ :param advan │
2025-10-08 12:07:28.030 [warning] [server stderr] │ 810 │ │ :return: if │
2025-10-08 12:07:28.030 [warning] [server stderr] │ returns raw response │
2025-10-08 12:07:28.030 [warning] [server stderr] │ 811 │ │ """ │
2025-10-08 12:07:28.031 [warning] [server stderr] │ ❱ 812 │ │ response = s │
2025-10-08 12:07:28.031 [warning] [server stderr] │ 813 │ │ │ "PUT", │
2025-10-08 12:07:28.031 [warning] [server stderr] │ 814 │ │ │ path=pat │
2025-10-08 12:07:28.031 [warning] [server stderr] │ 815 │ │ │ data=dat │
2025-10-08 12:07:28.032 [warning] [server stderr] │ │
2025-10-08 12:07:28.032 [warning] [server stderr] │ /app/.venv/lib/python3.10/s │
2025-10-08 12:07:28.032 [warning] [server stderr] │ ite-packages/atlassian/rest │
2025-10-08 12:07:28.032 [warning] [server stderr] │ _client.py:445 in request │
2025-10-08 12:07:28.032 [warning] [server stderr] │ │
2025-10-08 12:07:28.032 [warning] [server stderr] │ 442 │ │ if self.adva │
2025-10-08 12:07:28.032 [warning] [server stderr] │ 443 │ │ │ return r │
2025-10-08 12:07:28.032 [warning] [server stderr] │ 444 │ │ │
2025-10-08 12:07:28.032 [warning] [server stderr] │ ❱ 445 │ │ self.raise_f │
2025-10-08 12:07:28.032 [warning] [server stderr] │ 446 │ │ return respo │
2025-10-08 12:07:28.033 [warning] [server stderr] │ 447 │ │
2025-10-08 12:07:28.033 [warning] [server stderr] │ 448 │ # both True │
2025-10-08 12:07:28.033 [warning] [server stderr] │ │
2025-10-08 12:07:28.033 [warning] [server stderr] │ /app/.venv/lib/python3.10/s │
2025-10-08 12:07:28.033 [warning] [server stderr] │ ite-packages/atlassian/rest │
2025-10-08 12:07:28.033 [warning] [server stderr] │ _client.py:994 in │
2025-10-08 12:07:28.033 [warning] [server stderr] │ raise_for_status │
2025-10-08 12:07:28.033 [warning] [server stderr] │ │
2025-10-08 12:07:28.033 [warning] [server stderr] │ 991 │ │ │ │ log. │
2025-10-08 12:07:28.033 [warning] [server stderr] │ 992 │ │ │ │ resp │
2025-10-08 12:07:28.034 [warning] [server stderr] │ 993 │ │ │ else: │
2025-10-08 12:07:28.034 [warning] [server stderr] │ ❱ 994 │ │ │ │ rais │
2025-10-08 12:07:28.034 [warning] [server stderr] │ 995 │ │ else: │
2025-10-08 12:07:28.034 [warning] [server stderr] │ 996 │ │ │ response │
2025-10-08 12:07:28.034 [warning] [server stderr] │ 997 │
2025-10-08 12:07:28.034 [warning] [server stderr] ╰─────────────────────────────╯
2025-10-08 12:07:28.034 [warning] [server stderr] HTTPError: Internal server
2025-10-08 12:07:28.034 [warning] [server stderr] error
2025-10-08 12:07:28.034 [warning] [server stderr]
2025-10-08 12:07:28.034 [warning] [server stderr] The above exception was the
2025-10-08 12:07:28.034 [warning] [server stderr] direct cause of the following
2025-10-08 12:07:28.035 [warning] [server stderr] exception:
2025-10-08 12:07:28.035 [warning] [server stderr]
2025-10-08 12:07:28.035 [warning] [server stderr] ╭─ Traceback (most recent cal─╮
2025-10-08 12:07:28.035 [warning] [server stderr] │ /app/.venv/lib/python3.10/s │
2025-10-08 12:07:28.035 [warning] [server stderr] │ ite-packages/mcp_atlassian/ │
2025-10-08 12:07:28.035 [warning] [server stderr] │ servers/jira.py:940 in │
2025-10-08 12:07:28.035 [warning] [server stderr] │ update_issue │
2025-10-08 12:07:28.035 [warning] [server stderr] │ │
2025-10-08 12:07:28.035 [warning] [server stderr] │ 937 │ │ all_updates[ │
2025-10-08 12:07:28.035 [warning] [server stderr] │ 938 │ │
2025-10-08 12:07:28.036 [warning] [server stderr] │ 939 │ try: │
2025-10-08 12:07:28.036 [warning] [server stderr] │ ❱ 940 │ │ issue = jira │
2025-10-08 12:07:28.036 [warning] [server stderr] │ 941 │ │ result = iss │
2025-10-08 12:07:28.036 [warning] [server stderr] │ 942 │ │ if ( │
2025-10-08 12:07:28.036 [warning] [server stderr] │ 943 │ │ │ hasattr( │
2025-10-08 12:07:28.036 [warning] [server stderr] │ │
2025-10-08 12:07:28.036 [warning] [server stderr] │ /app/.venv/lib/python3.10/s │
2025-10-08 12:07:28.037 [warning] [server stderr] │ ite-packages/mcp_atlassian/ │
2025-10-08 12:07:28.037 [warning] [server stderr] │ jira/issues.py:1094 in │
2025-10-08 12:07:28.037 [warning] [server stderr] │ update_issue │
2025-10-08 12:07:28.037 [warning] [server stderr] │ │
2025-10-08 12:07:28.037 [warning] [server stderr] │ 1091 │ │ except Excep │
2025-10-08 12:07:28.037 [warning] [server stderr] │ 1092 │ │ │ error_ms │
2025-10-08 12:07:28.037 [warning] [server stderr] │ 1093 │ │ │ logger.e │
2025-10-08 12:07:28.037 [warning] [server stderr] │ ❱ 1094 │ │ │ raise Va │
2025-10-08 12:07:28.037 [warning] [server stderr] │ 1095 │ │
2025-10-08 12:07:28.038 [warning] [server stderr] │ 1096 │ def _update_issu │
2025-10-08 12:07:28.038 [warning] [server stderr] │ 1097 │ │ self, issue_ │
2025-10-08 12:07:28.038 [warning] [server stderr] ╰─────────────────────────────╯
2025-10-08 12:07:28.038 [warning] [server stderr] ValueError: Failed to update
2025-10-08 12:07:28.038 [warning] [server stderr] issue FDM-2364: Internal server
2025-10-08 12:07:28.038 [warning] [server stderr] error
2025-10-08 12:07:28.038 [warning] [server stderr]
2025-10-08 12:07:28.038 [warning] [server stderr] During handling of the above
2025-10-08 12:07:28.038 [warning] [server stderr] exception, another exception
2025-10-08 12:07:28.038 [warning] [server stderr] occurred:
2025-10-08 12:07:28.039 [warning] [server stderr]
2025-10-08 12:07:28.039 [warning] [server stderr] ╭─ Traceback (most recent cal─╮
2025-10-08 12:07:28.039 [warning] [server stderr] │ /app/.venv/lib/python3.10/s │
2025-10-08 12:07:28.039 [warning] [server stderr] │ ite-packages/fastmcp/tools/ │
2025-10-08 12:07:28.039 [warning] [server stderr] │ tool_manager.py:120 in │
2025-10-08 12:07:28.039 [warning] [server stderr] │ call_tool │
2025-10-08 12:07:28.039 [warning] [server stderr] │ │
2025-10-08 12:07:28.039 [warning] [server stderr] │ 117 │ │ │ raise Not │
2025-10-08 12:07:28.039 [warning] [server stderr] │ 118 │ │ │
2025-10-08 12:07:28.039 [warning] [server stderr] │ 119 │ │ try: │
2025-10-08 12:07:28.040 [warning] [server stderr] │ ❱ 120 │ │ │ return aw │
2025-10-08 12:07:28.040 [warning] [server stderr] │ 121 │ │ │
2025-10-08 12:07:28.040 [warning] [server stderr] │ 122 │ │ # raise ToolE │
2025-10-08 12:07:28.040 [warning] [server stderr] │ 123 │ │ except ToolEr │
2025-10-08 12:07:28.040 [warning] [server stderr] │ │
2025-10-08 12:07:28.040 [warning] [server stderr] │ /app/.venv/lib/python3.10/s │
2025-10-08 12:07:28.040 [warning] [server stderr] │ ite-packages/fastmcp/tools/ │
2025-10-08 12:07:28.040 [warning] [server stderr] │ tool.py:144 in run │
2025-10-08 12:07:28.040 [warning] [server stderr] │ │
2025-10-08 12:07:28.040 [warning] [server stderr] │ 141 │ │ type_adapter │
2025-10-08 12:07:28.041 [warning] [server stderr] │ 142 │ │ result = type │
2025-10-08 12:07:28.041 [warning] [server stderr] │ 143 │ │ if inspect.is │
2025-10-08 12:07:28.041 [warning] [server stderr] │ ❱ 144 │ │ │ result = │
2025-10-08 12:07:28.041 [warning] [server stderr] │ 145 │ │ │
2025-10-08 12:07:28.042 [warning] [server stderr] │ 146 │ │ return _conve │
2025-10-08 12:07:28.042 [warning] [server stderr] │ 147 │
2025-10-08 12:07:28.042 [warning] [server stderr] │ │
2025-10-08 12:07:28.042 [warning] [server stderr] │ /app/.venv/lib/python3.10/s │
2025-10-08 12:07:28.042 [warning] [server stderr] │ ite-packages/mcp_atlassian/ │
2025-10-08 12:07:28.042 [warning] [server stderr] │ utils/decorators.py:42 in │
2025-10-08 12:07:28.042 [warning] [server stderr] │ wrapper │
2025-10-08 12:07:28.043 [warning] [server stderr] │ │
2025-10-08 12:07:28.043 [warning] [server stderr] │ 39 │ │ │ logger.wa │
2025-10-08 12:07:28.043 [warning] [server stderr] │ 40 │ │ │ raise Val │
2025-10-08 12:07:28.043 [warning] [server stderr] │ 41 │ │ │
2025-10-08 12:07:28.043 [warning] [server stderr] │ ❱ 42 │ │ return await │
2025-10-08 12:07:28.043 [warning] [server stderr] │ 43 │ │
2025-10-08 12:07:28.043 [warning] [server stderr] │ 44 │ return wrapper # │
2025-10-08 12:07:28.043 [warning] [server stderr] │ 45 │
2025-10-08 12:07:28.043 [warning] [server stderr] │ │
2025-10-08 12:07:28.043 [warning] [server stderr] │ /app/.venv/lib/python3.10/s │
2025-10-08 12:07:28.043 [warning] [server stderr] │ ite-packages/mcp_atlassian/ │
2025-10-08 12:07:28.043 [warning] [server stderr] │ servers/jira.py:954 in │
2025-10-08 12:07:28.044 [warning] [server stderr] │ update_issue │
2025-10-08 12:07:28.044 [warning] [server stderr] │ │
2025-10-08 12:07:28.044 [warning] [server stderr] │ 951 │ │ ) │
2025-10-08 12:07:28.044 [warning] [server stderr] │ 952 │ except Exception │
2025-10-08 12:07:28.044 [warning] [server stderr] │ 953 │ │ logger.error │
2025-10-08 12:07:28.044 [warning] [server stderr] │ ❱ 954 │ │ raise ValueE │
2025-10-08 12:07:28.044 [warning] [server stderr] │ 955 │
2025-10-08 12:07:28.044 [warning] [server stderr] │ 956 │
2025-10-08 12:07:28.044 [warning] [server stderr] │ 957 @jira_mcp.tool(tags= │
2025-10-08 12:07:28.044 [warning] [server stderr] ╰─────────────────────────────╯
2025-10-08 12:07:28.045 [warning] [server stderr] ValueError: Failed to update
2025-10-08 12:07:28.045 [warning] [server stderr] issue FDM-2364: Failed to
2025-10-08 12:07:28.045 [warning] [server stderr] update issue FDM-2364: Internal
2025-10-08 12:07:28.045 [warning] [server stderr] server error
2025-10-08 12:07:28.045 [warning] [server stderr] ERROR - FastMCP.fastmcp.tools.tool_manager - Error calling tool 'update_issue': Failed to update issue FDM-2364: Failed to update issue FDM-2364: Internal server error
2025-10-08 12:07:28.045 [warning] [server stderr] Traceback (most recent call last):
2025-10-08 12:07:28.045 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/mcp_atlassian/jira/issues.py", line 1058, in update_issue
2025-10-08 12:07:28.045 [warning] [server stderr] self.jira.update_issue(
2025-10-08 12:07:28.045 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/atlassian/jira.py", line 1479, in update_issue
2025-10-08 12:07:28.046 [warning] [server stderr] return self.put(endpoint, data=update)
2025-10-08 12:07:28.046 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/atlassian/rest_client.py", line 812, in put
2025-10-08 12:07:28.046 [warning] [server stderr] response = self.request(
2025-10-08 12:07:28.046 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/atlassian/rest_client.py", line 445, in request
2025-10-08 12:07:28.046 [warning] [server stderr] self.raise_for_status(response)
2025-10-08 12:07:28.046 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/atlassian/rest_client.py", line 994, in raise_for_status
2025-10-08 12:07:28.046 [warning] [server stderr] raise HTTPError(error_msg, response=response)
2025-10-08 12:07:28.046 [warning] [server stderr] requests.exceptions.HTTPError: Internal server error
2025-10-08 12:07:28.047 [warning] [server stderr]
2025-10-08 12:07:28.047 [warning] [server stderr] The above exception was the direct cause of the following exception:
2025-10-08 12:07:28.047 [warning] [server stderr]
2025-10-08 12:07:28.047 [warning] [server stderr] Traceback (most recent call last):
2025-10-08 12:07:28.047 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/mcp_atlassian/servers/jira.py", line 940, in update_issue
2025-10-08 12:07:28.047 [warning] [server stderr] issue = jira.update_issue(issue_key=issue_key, **all_updates)
2025-10-08 12:07:28.048 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/mcp_atlassian/jira/issues.py", line 1094, in update_issue
2025-10-08 12:07:28.048 [warning] [server stderr] raise ValueError(f"Failed to update issue {issue_key}: {error_msg}") from e
2025-10-08 12:07:28.048 [warning] [server stderr] ValueError: Failed to update issue FDM-2364: Internal server error
2025-10-08 12:07:28.048 [warning] [server stderr]
2025-10-08 12:07:28.049 [warning] [server stderr] During handling of the above exception, another exception occurred:
2025-10-08 12:07:28.049 [warning] [server stderr]
2025-10-08 12:07:28.049 [warning] [server stderr] Traceback (most recent call last):
2025-10-08 12:07:28.049 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/fastmcp/tools/tool_manager.py", line 120, in call_tool
2025-10-08 12:07:28.049 [warning] [server stderr] return await tool.run(arguments)
2025-10-08 12:07:28.049 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/fastmcp/tools/tool.py", line 144, in run
2025-10-08 12:07:28.050 [warning] [server stderr] result = await result
2025-10-08 12:07:28.050 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/mcp_atlassian/utils/decorators.py", line 42, in wrapper
2025-10-08 12:07:28.050 [warning] [server stderr] return await func(ctx, *args, **kwargs)
2025-10-08 12:07:28.050 [warning] [server stderr] File "/app/.venv/lib/python3.10/site-packages/mcp_atlassian/servers/jira.py", line 954, in update_issue
2025-10-08 12:07:28.050 [warning] [server stderr] raise ValueError(f"Failed to update issue {issue_key}: {str(e)}")
2025-10-08 12:07:28.050 [warning] [server stderr] ValueError: Failed to update issue FDM-2364: Failed to update issue FDM-2364: Internal server errormcp-atlassian Version
latest
Installation Method
Docker
Operating System
Windows
Python Version
Python 3.13.3
Atlassian Instance Type
Jira Server / Data Center
Client Application
VS Code
Additional Context
No response