Pages

Get Page¶

Get content of a specific Confluence page by its ID, or by its title and space key.

Parameters:

Parameter	Type	Required	Description
`page_id`	`string`	No	Confluence page ID (numeric ID, can be found in the page URL). For example, in the URL 'https://example.atlassian.net/wiki/spaces/TEAM/pages/123456789/Page+Title', the page ID is '123456789'. Provide this OR both 'title' and 'space_key'. If page_id is provided, title and space_key will be ignored.
`title`	`string`	No	The exact title of the Confluence page. Use this with 'space_key' if 'page_id' is not known.
`space_key`	`string`	No	The key of the Confluence space where the page resides (e.g., 'DEV', 'TEAM'). Required if using 'title'.
`include_metadata`	`boolean`	No	Whether to include page metadata such as creation date, last update, version, and labels.
`convert_to_markdown`	`boolean`	No	Whether to convert page to markdown (true) or keep it in raw HTML format (false). Raw HTML can reveal macros (like dates) not visible in markdown, but CAUTION: using HTML significantly increases token usage in AI responses.
Example:

{"page_id": "12345678", "include_metadata": true}

Tip

Content is returned in Markdown format (auto-converted from Confluence storage format). Use include_metadata for labels, version info, and last modified date.

Create Page¶

Create a new Confluence page.

Note

This is a write tool. Disabled when READ_ONLY_MODE=true.

Parameters:

Parameter	Type	Required	Description
`space_key`	`string`	Yes	The key of the space to create the page in (usually a short uppercase code like 'DEV', 'TEAM', or 'DOC')
`title`	`string`	Yes	The title of the page
`content`	`string`	Yes	The content of the page. Format depends on content_format parameter. Can be Markdown (default), wiki markup, or storage format
`parent_id`	`string`	No	(Optional) parent page ID. If provided, this page will be created as a child of the specified page
`content_format`	`string`	No	(Optional) The format of the content parameter. Options: 'markdown' (default), 'wiki', or 'storage'. Wiki format uses Confluence wiki markup syntax
`enable_heading_anchors`	`boolean`	No	(Optional) Whether to enable automatic heading anchor generation. Only applies when content_format is 'markdown'
`include_content`	`boolean`	No	(Optional) Whether to include page content in the response. Defaults to false since callers already have the content at create time.
`emoji`	`string`	No	(Optional) Page title emoji (icon shown in navigation). Can be any emoji character like '📝', '🚀', '📚'. Set to null/None to remove.
Example:

{"space_key": "DEV", "title": "Architecture Decision Record", "content": "## Context\n\nWe need to decide...", "parent_id": "98765432"}

Tip

Use Markdown for content — it's auto-converted to Confluence storage format. Specify parent_id to create as a child page.

Update Page¶

Update an existing 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 update
`title`	`string`	Yes	The new title of the page
`content`	`string`	Yes	The new content of the page. Format depends on content_format parameter
`is_minor_edit`	`boolean`	No	Whether this is a minor edit
`version_comment`	`string`	No	Optional comment for this version
`parent_id`	`string`	No	Optional the new parent page ID
`content_format`	`string`	No	(Optional) The format of the content parameter. Options: 'markdown' (default), 'wiki', or 'storage'. Wiki format uses Confluence wiki markup syntax
`enable_heading_anchors`	`boolean`	No	(Optional) Whether to enable automatic heading anchor generation. Only applies when content_format is 'markdown'
`include_content`	`boolean`	No	(Optional) Whether to include page content in the response. Defaults to false since callers already have the content at update time.
`emoji`	`string`	No	(Optional) Page title emoji (icon shown in navigation). Can be any emoji character like '📝', '🚀', '📚'. Set to null/None to remove.
Example:

{"page_id": "12345678", "title": "Updated Title", "content": "## Updated Content\n\nNew information...", "is_minor_edit": true}

Tip

Set is_minor_edit: true to skip notification emails. The page version is auto-incremented.

Delete Page¶

Delete an existing 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 delete

Get Page Children¶

Get child pages and folders of a specific Confluence page.

Parameters:

Parameter	Type	Required	Description
`parent_id`	`string`	Yes	The ID of the parent page whose children you want to retrieve
`expand`	`string`	No	Fields to expand in the response (e.g., 'version', 'body.storage')
`limit`	`integer`	No	Maximum number of child items to return (1-50)
`include_content`	`boolean`	No	Whether to include the page content in the response
`convert_to_markdown`	`boolean`	No	Whether to convert page content to markdown (true) or keep it in raw HTML format (false). Only relevant if include_content is true.
`start`	`integer`	No	Starting index for pagination (0-based)
`include_folders`	`boolean`	No	Whether to include child folders in addition to child pages

Get Page History¶

Get a historical version of a specific 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', the page ID is '123456789'.
`version`	`integer`	Yes	The version number of the page to retrieve
`convert_to_markdown`	`boolean`	No	Whether to convert page to markdown (true) or keep it in raw HTML format (false). Raw HTML can reveal macros (like dates) not visible in markdown, but CAUTION: using HTML significantly increases token usage in AI responses.

Move Page¶

Move a Confluence page to a new parent or space.

Note

This is a write tool. Disabled when READ_ONLY_MODE=true.

Parameters:

Parameter	Type	Required	Description
`page_id`	`string`	Yes	ID of the page to move
`target_parent_id`	`string`	No*	Target parent page ID. If omitted with `target_space_key`, moves to space root.
`target_space_key`	`string`	No*	Target space key for cross-space moves
`position`	`string`	No	Position: 'append' (default, move as child of target), 'above' (move before target as sibling), or 'below' (move after target as sibling)

Example:

{"page_id": "12345678", "target_parent_id": "98765432"}

Warning

At least one of target_parent_id or target_space_key must be provided.

Tip

Use target_space_key to move pages between spaces. Omit target_parent_id with a space key to move to the space root.

Get Page Diff¶

Get a unified diff between two versions of 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', the page ID is '123456789'.
`from_version`	`integer`	Yes	Source version number (>=1)
`to_version`	`integer`	Yes	Target version number (>=1)

Example:

{"page_id": "12345678", "from_version": 1, "to_version": 3}

Tip

Use confluence_get_page_history to discover available version numbers. The diff is in unified format, showing additions and removals between versions.