manage_attachments

Manage Jira issue attachments.

Actions

Action	Description	Required Params	Permission
`list`	List attachments on an issue	`issue_key`	BROWSE_PROJECTS
`download`	Download an attachment	`attachment_id`	BROWSE_PROJECTS
`upload`	Upload a file as an attachment	`issue_key`, `file_path`	CREATE_ATTACHMENTS
`delete`	Delete an attachment	`attachment_id`	DELETE_ALL_ATTACHMENTS

Parameters

Parameter	Type	Description
`action`	string	Required. `list`, `download`, `upload`, or `delete`
`issue_key`	string	Jira issue key (for `list`, `upload`)
`attachment_id`	string	Attachment ID (for `download`, `delete`)
`file_path`	string	Absolute path to the file to upload (for `upload`). Note: paths refer to the MCP server’s filesystem. In stdio mode this is the local machine.

Examples

List attachments

{
  "action": "list",
  "issue_key": "PROJ-123"
}

Response:

{
  "issue_key": "PROJ-123",
  "total": 2,
  "attachments": [
    {
      "id": "10200",
      "filename": "screenshot.png",
      "author": "Jane Doe",
      "created": "2025-01-14T10:00:00.000+0000",
      "size": 245760,
      "mime_type": "image/png"
    },
    {
      "id": "10201",
      "filename": "logs.txt",
      "author": "Bob Smith",
      "created": "2025-01-14T11:00:00.000+0000",
      "size": 1024,
      "mime_type": "text/plain"
    }
  ]
}

Download an attachment

{
  "action": "download",
  "attachment_id": "10200"
}

Response:

{
  "attachment_id": "10200",
  "filename": "screenshot.png",
  "size": 245760,
  "mime_type": "image/png",
  "saved_to": "/tmp/jtk-downloads/screenshot.png",
  "status": "downloaded"
}

Downloaded files are saved to a temporary directory at /tmp/jtk-downloads/.

Upload a file

{
  "action": "upload",
  "issue_key": "PROJ-123",
  "file_path": "/path/to/report.pdf"
}

Response:

{
  "id": "10202",
  "filename": "report.pdf",
  "size": 51200,
  "mime_type": "application/pdf",
  "issue_key": "PROJ-123",
  "status": "uploaded"
}

Delete an attachment

{
  "action": "delete",
  "attachment_id": "10200"
}

Response:

{
  "attachment_id": "10200",
  "status": "deleted"
}