> ## 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`.</Note>

**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.
</Tip>

***

### 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`.</Note>

**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.
</Tip>

***

### 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') |

***

### 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`.</Note>

**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.
</Tip>

<Warning>
  Analytics features may require additional permissions on Server/DC.
</Warning>

***