manage_attachments

Unified tool for Confluence page attachment operations.

Actions

Action	Description	Required Params	Write Gated
`list`	List all attachments on a page	`page_id`	No
`download`	Download an attachment	`attachment_id`	No
`upload`	Upload a file as an attachment	`page_id`, `file_path`	Yes
`delete`	Delete an attachment	`attachment_id`	Yes

Parameters

Parameter	Type	Description
`action`	string	Required. `list`, `download`, `upload`, or `delete`
`page_id`	string	Page ID (required for `list`, `upload`)
`attachment_id`	string	Attachment ID (required for `download`, `delete`)
`file_path`	string	Absolute path to the file to upload (required for `upload`). Note: paths refer to the MCP server’s filesystem. In stdio mode this is the local machine.
`comment`	string	Optional comment for the attachment (for `upload`)
`limit`	int	Results per page (default 25)
`cursor`	string	Pagination cursor for next page

Examples

List attachments

{
  "action": "list",
  "page_id": "12345678"
}

Response:

[
  {
    "id": "att55443322",
    "title": "architecture-diagram.png",
    "media_type": "image/png",
    "file_size": 245760,
    "page_id": "12345678",
    "created": "2025-02-15T14:00:00Z",
    "comment": "Updated diagram"
  }
]

Download an attachment

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

Response:

{
  "path": "/tmp/ctk-downloads/architecture-diagram.png",
  "filename": "architecture-diagram.png",
  "media_type": "image/png",
  "size_bytes": 245760
}

Upload a file

{
  "action": "upload",
  "page_id": "12345678",
  "file_path": "/path/to/report.pdf",
  "comment": "Q4 report"
}

Response:

{
  "id": "att55443323",
  "title": "report.pdf",
  "media_type": "application/pdf",
  "file_size": 51200,
  "status": "uploaded"
}

Delete an attachment

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

Response:

Attachment deleted successfully