Comment on a Jira work item

Comment on a Jira work item

Adds a comment to a Jira work item and returns the new comment.

On the API the comment body is Atlassian Document Format; the CLI takes --key and a plain-text or ADF --body, and can comment on every work item a --jql query matches. addOrEditJiraIssueComment also edits an existing comment.

Set up

Use the first option your agent supports.

MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

{ "mcpServers": { "atlassian": { "url": "https://mcp.atlassian.com/v2/mcp" } } }

Call the MCP tool addOrEditJiraIssueComment.

Server URL: https://mcp.atlassian.com/v2/mcp

CLI (official)

Install the command, then confirm it runs.

brew tap atlassian/homebrew-acli && brew install acli
acli --version

Run acli jira workitem comment create.

API (official)

• Base URL: https://{your-domain}.atlassian.net
• Endpoint: POST /rest/api/3/issue/{issueIdOrKey}/comment
• Auth: send the header Authorization: Basic $ATLASSIAN_API_KEY
• Get a key: https://id.atlassian.com/manage-profile/security/api-tokens
• Docs: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/

Before doing anything else, make one read-only call to confirm access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data.
• Never print API keys.