Atlassian Confluence

Connect with Atlassian Confluence to manage team collaboration and documentation platform.

Key Features

• Page and blog post management
• Space and permission management
• Content search and retrieval
• User search and management
• Comments and collaboration features
• Attachment management

Basic Information

Authentication Method

Uses OAuth 2.0 for authentication.

Required Permissions

• delete:page:confluence: Delete pages
• offline_access: Offline access
• read:me: Read user information
• read:page:confluence: Read pages
• read:space:confluence: Read spaces
• read:user:confluence: Read user information
• write:page:confluence: Write pages
• search:confluence: Search functionality
• read:content-details:confluence: Read content details

Supported MCP Tools

Space Management Tools

get_spaces

Returns all spaces. Results are sorted by ID in ascending order, and the number of results can be limited by the limit parameter.

Page Management Tools

get_pages

Returns all pages. The number of results can be limited by the limit parameter, and additional results (if available) will be available through the next URL in the Link response header.

get_page_by_id

Returns a specific page.

create_page

Creates a page in the space.

update_page

Updates a page by ID.

delete_page

Deletes a page by ID.

User Management Tools

bulk_user_lookup

Returns user details for the IDs provided in the request body.

search_users

Searches for users using user-specific queries from the Confluence Query Language (CQL).

Search Tools

search_content

Searches for content using the Confluence Query Language (CQL).

Usage Example

For example,

• When you input “Retrieve the list of pages in a specific space” as a prompt,
• LLM calls the get_pages tool via MCP to retrieve the page list.
• Then, it responds in the chat based on the tool call results.

OAuth App Setup Method

1. Create an OAuth 2.0 app in the Atlassian Developer Console.
2. Set the required permission scopes.
3. Configure the callback URL.
4. Safely store the generated Client ID and Client Secret.

Notes

• Keep your OAuth credentials secure.
• It’s recommended to grant only the minimum necessary permissions.
• It’s recommended to use HTTPS.
• Follow Confluence’s query syntax when writing CQL queries.

Notice Regarding Content Preservation

Currently, when using the update_page tool, original media content such as images, videos, and attachments may be deleted or lost due to the token-saving response simplification method. Content preservation will be applied by default soon, and the token-saving response simplification feature will be provided as an option.

Limitations

Currently, the Confluence API response’s ADF (JSON format) document structure is traversed, and only basic text formatting such as headings, lists, and code blocks is converted to Markdown.

⚠️ To reduce data size and save tokens, ADF’s unique visual, dynamic, and structural features are intentionally removed or simplified.

Features that are completely lost:

• media, mediaSingle: Images, videos, and attachments
• layoutSection, layoutColumn: Multi-column layouts (flattened into a single column)
• extension, bodiedExtension: All macros such as table of contents and Jira issues
• mention: User mentions (@username)
• taskList, decisionList: Checklists and decisions
• emoji: Emojis

Features that are simplified:

• table: Converted to a basic Markdown table with merged cells, background colors, and header formatting removed
• panel: Converted to a simple blockquote with colors and icons removed
• inlineCard: Converted to a simple link with previews removed
• date: Converted to plain text in YYYY-MM-DD format
• marks: Advanced formatting such as text color, superscript, and subscript is ignored

⚠️ Recommendation For pages that include important formatting such as images, tables, or layouts, be sure to edit and review them directly in Confluence to prevent data loss.