> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-atlassian.soomiles.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Confluence Comments & Labels

> Comments, labels, and page analytics

### Add Comment

Add a comment to a Confluence page.

> [!NOTE]
>
> This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `page_id` | `string` | Yes | The ID of the page to add a comment to |
| `body` | `string` | Yes | The comment content in Markdown format |
| **Example:** | | | |

```json theme={null}
{"page_id": "12345678", "body": "Great documentation! Consider adding examples for the API section."}
```

> [!TIP]
>
> Supports Markdown formatting. Comments are added to the page's comment section.

***

### Get Comments

Get comments for a specific Confluence page.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `page_id` | `string` | Yes | Confluence page ID (numeric ID, can be parsed from URL, e.g. from '[https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title](https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title)' -> '123456789') |

> [!NOTE]
>
> Replies include `parent_comment_id` when Confluence provides the parent thread. Inline comments also include `marker_ref`, `original_selection`, and `resolution_status` when available.

***

### Reply to Comment

Reply to an existing comment thread on a Confluence page.

> [!NOTE]
>
> This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `comment_id` | `string` | Yes | The ID of the parent comment to reply to |
| `body` | `string` | Yes | The reply content in Markdown format |
| **Example:** | | | |

```json theme={null}
{"comment_id": "67890", "body": "Thanks for the feedback! I've updated the section."}
```

> [!TIP]
>
> Get comment IDs from `confluence_get_comments`. Replies are threaded under the parent comment.

***

### Get Inline Comments

Get all inline comments for a Confluence page.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `page_id` | `string` | Yes | The ID of the page to get inline comments from |

> [!NOTE]
>
> Each inline comment includes `parent_comment_id`, `marker_ref`, `original_selection`, and `resolution_status` when Confluence provides those values.

***

### Add Inline Comment

Add an inline comment anchored to a text selection on a page.

> [!NOTE]
>
> This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `page_id` | `string` | Yes | The ID of the page to add the inline comment to |
| `body` | `string` | Yes | The comment content in Markdown format |
| `text_selection` | `string` | Yes | The exact text on the page to anchor the inline comment to. Must match text that exists in the page content. |
| `text_selection_match_count` | `integer` | No | Total number of times the selected text appears on the page. Defaults to 1. |
| `text_selection_match_index` | `integer` | No | Zero-based index of which occurrence of the text to anchor to. Defaults to 0 (first occurrence). |

***

### Get Labels

Get labels for Confluence content (pages, blog posts, or attachments).

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `page_id` | `string` | Yes | Confluence content ID (page, blog post, or attachment). For pages: numeric ID from URL (e.g., '123456789'). For attachments: ID with 'att' prefix (e.g., 'att123456789'). Works with any Confluence content type that supports labels. |

***

### Add Label

Add label to Confluence content (pages, blog posts, or attachments).

> [!NOTE]
>
> This is a **write** tool. Disabled when `READ_ONLY_MODE=true`.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `page_id` | `string` | Yes | Confluence content ID to label. For pages/blogs: numeric ID (e.g., '123456789'). For attachments: ID with 'att' prefix (e.g., 'att123456789'). Use get\_attachments to find attachment IDs. |
| `name` | `string` | Yes | Label name to add (lowercase, no spaces). Examples: 'draft', 'reviewed', 'confidential', 'v1.0'. Labels help organize and categorize content. |

***

### Get Page Views

Get view statistics for a Confluence page.

**Parameters:**

| Parameter | Type | Required | Description |
| - | - | - | - |
| `page_id` | `string` | Yes | Confluence page ID (numeric ID, can be found in the page URL). For example, in '[https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title](https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title)', the page ID is '123456789'. |
| `include_title` | `boolean` | No | Whether to fetch and include the page title |
| **Example:** | | | |

```json theme={null}
{"page_id": "12345678", "period": "lastMonth"}
```

> [!TIP]
>
> Useful for identifying popular or stale content. Available periods depend on your Confluence analytics configuration.

> [!WARNING]
>
> Analytics features may require additional permissions on Server/DC.

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.