Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CONFLUENCE_URLYesThe base URL of your Confluence Cloud instance, e.g. https://your-domain.atlassian.net/wiki
CONFLUENCE_USERNAMENoYour email address for basic auth
CONFLUENCE_API_TOKENNoYour API token for basic auth
CONFLUENCE_OAUTH_CLIENT_IDNoOAuth 2.0 client ID
CONFLUENCE_OAUTH_CLIENT_SECRETNoOAuth 2.0 client secret
CONFLUENCE_OAUTH_REFRESH_TOKENNoOAuth 2.0 initial refresh token

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
confluence_get_pageA

Fetch a Confluence page and cache it locally for editing.

Returns the page metadata and the local cache file path. Edit the cached file
directly, then call confluence_push_page to publish your changes.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
confluence_edit_pageA

Find and replace text in a cached Confluence page.

Operates on the local cache file. Call confluence_get_page first to cache the page,
then use this to make edits, then confluence_push_page to publish.

Args:
    page_id: The page ID to edit.
    find: The text to find in the page content.
    replace: The text to replace it with.
    replace_all: If true, replace all occurrences. If false, replace only the first.
confluence_push_pageA

Push the cached page to Confluence.

Reads title and ADF body from the local cache file, fetches the latest version
number from Confluence to avoid conflicts, then publishes.

Call confluence_get_page first, edit the cache file, then call this.

Args:
    page_id: The page ID to push.
    version_message: Optional message describing the change.
confluence_find_replaceA

Fetch a Confluence page, find and replace text, and push the result in one step.

Combines get_page + edit_page + push_page into a single call. Only replaces
within text content nodes — structural ADF elements are never modified.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    find: The text to find in the page content.
    replace: The text to replace it with.
    replace_all: If true, replace all occurrences. If false, replace only the first.
    version_message: Optional message describing the change.
confluence_create_pageA

Create a new Confluence page with ADF content.

Args:
    space_id: The space ID to create the page in.
    title: The page title.
    adf_body: The full ADF document as a JSON string, e.g. {"type": "doc", "version": 1, "content": [...]}.
    parent_id: Optional parent page ID to nest under.
confluence_replace_mentionA

Replace all @mentions of one user with another on a Confluence page.

Fetches the page, searches for mention nodes matching find_user, looks up
the replace_user's account ID, swaps the mentions, and pushes in one step.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    find_user: Name to find (partial match on mention text, e.g. "Ali").
    replace_user: Name to replace with (searched in Confluence users, e.g. "Mark").
confluence_search_pagesA

Search Confluence pages using CQL (Confluence Query Language).

Returns page titles, IDs, and spaces matching the query. Supports CQL operators
like AND, OR, ~, =, etc. Simple text is treated as a title/content search.

Args:
    query: CQL query string, e.g. 'type=page AND title~"meeting notes"' or just "meeting notes".
    limit: Maximum number of results to return (default 10, max 50).
    cursor: Pagination cursor from a previous search result.
confluence_list_pagesB

List pages in a Confluence space.

Args:
    space_id: The numeric space ID.
    limit: Maximum number of pages to return (default 25, max 250).
    sort: Sort order — "title", "-title", "created-date", "-modified-date", etc.
    cursor: Pagination cursor from a previous result.
confluence_get_child_pagesA

Get child pages of a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    limit: Maximum number of children to return (default 25, max 250).
    cursor: Pagination cursor from a previous result.
confluence_get_ancestorsA

Get the ancestor (parent) chain of a Confluence page.

Returns the page hierarchy from the space root down to the immediate parent.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
confluence_get_labelsA

Get all labels on a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
confluence_add_labelsA

Add labels to a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    labels: List of label names to add, e.g. ["important", "reviewed"].
confluence_remove_labelA

Remove a label from a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    label: The label name to remove.
confluence_list_versionsA

List version history of a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    limit: Maximum number of versions to return (default 10, max 50).
    cursor: Pagination cursor from a previous result.
confluence_extract_textA

Extract plain text content from a Confluence page.

Fetches the page ADF and converts it to readable plaintext with basic
formatting (paragraphs, bullet lists, tables, code blocks, etc.).

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
confluence_update_taskA

Toggle a task (checkbox) item on a Confluence page.

Finds a taskItem whose text contains task_text and sets its state.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    task_text: Text substring to match the task item (e.g. "Review PR").
    state: New state — "DONE" or "TODO".
confluence_regex_replaceA

Find and replace text using a regex pattern on a Confluence page.

Applies re.sub() to every text node in the ADF. Supports capture groups
in the replacement string (e.g. r"\1").

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    pattern: Python regex pattern to match.
    replacement: Replacement string (supports backreferences like \1).
    version_message: Optional message describing the change.
confluence_update_table_cellA

Update a single cell in a table on a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    row: Zero-based row index.
    col: Zero-based column index.
    value: New text value for the cell.
    table_index: Which table on the page (0-based, default first table).
confluence_insert_table_rowA

Insert a new row into a table on a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    row_index: Position to insert at (0-based). Use -1 to append at the end.
    values: List of cell values for the new row.
    table_index: Which table on the page (0-based, default first table).
confluence_delete_table_rowA

Delete a row from a table on a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    row_index: Zero-based row index to delete.
    table_index: Which table on the page (0-based, default first table).
confluence_add_commentA

Add a footer comment to a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    body: The comment text (plain text, converted to simple ADF paragraph).
    parent_comment_id: Optional parent comment ID for threaded replies.
confluence_list_commentsA

List footer comments on a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    limit: Maximum number of comments to return (default 25, max 100).
    cursor: Pagination cursor from a previous result.
confluence_compare_versionsA

Compare two versions of a Confluence page as a unified text diff.

Fetches the ADF for both versions, extracts plaintext, and produces a
unified diff showing what changed.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    version_a: The "before" version number.
    version_b: The "after" version number.
confluence_list_attachmentsA

List attachments on a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    limit: Maximum number of attachments to return (default 25, max 100).
    cursor: Pagination cursor from a previous result.
confluence_get_contributorsA

Get unique contributors to a Confluence page from its version history.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
confluence_add_linkA

Add a hyperlink to a Confluence page.

If after_text is provided, the link is inserted right after the first occurrence
of that text in a paragraph. Otherwise it's appended as a new paragraph at the
end of the page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    link_text: The display text for the link.
    url: The URL to link to.
    after_text: Optional text to insert the link after (inline within a paragraph).
confluence_upload_attachmentC

Upload a file as an attachment to a Confluence page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    file_path: Local file path to upload.
    comment: Optional comment for the attachment.
confluence_set_restrictionsA

Set access restrictions on a Confluence page.

Replaces existing restrictions for the given operation. To remove all
restrictions, pass empty users and groups lists.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    operation: The operation to restrict — "read" or "update".
    users: List of account IDs to grant access.
    groups: List of group names to grant access.
confluence_watch_pageA

Watch or unwatch a Confluence page for the authenticated user.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    watch: True to start watching, False to stop watching.
confluence_revert_pageA

Revert a Confluence page to a previous version.

Uses the v1 REST API restore operation to roll back a page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    version_number: The version number to revert to.
    version_message: Optional message describing the revert.
confluence_list_spacesB

List Confluence spaces.

Args:
    limit: Maximum number of spaces to return (default 25, max 250).
    type: Filter by space type — "global" or "personal". Empty for all.
    status: Filter by status — "current" (default) or "archived".
    cursor: Pagination cursor from a previous result.
confluence_archive_pageA

Archive a Confluence page.

DESTRUCTIVE: This removes the page from active view. By default this tool
runs in preview mode — call with confirm=True to actually archive.

You MUST show the preview to the user and get their explicit approval before
calling again with confirm=True.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    confirm: Must be True to actually archive. False (default) shows a preview.
confluence_move_pageA

Move a Confluence page to a new parent.

DESTRUCTIVE: This changes the page's location in the content tree. By default
this tool runs in preview mode — call with confirm=True to actually move.

You MUST show the preview to the user and get their explicit approval before
calling again with confirm=True.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    target_parent_id: The page ID of the new parent page.
    confirm: Must be True to actually move. False (default) shows a preview.
confluence_download_attachmentA

Download an attachment from a Confluence page to a local file.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    attachment_title: The filename of the attachment to download (e.g. "report.pdf").
    save_path: Local file path to save the downloaded file.
confluence_delete_attachmentA

Delete an attachment from a Confluence page.

DESTRUCTIVE: This permanently removes the attachment. By default this tool
runs in preview mode — call with confirm=True to actually delete.

You MUST show the preview to the user and get their explicit approval before
calling again with confirm=True.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    attachment_title: The filename of the attachment to delete.
    confirm: Must be True to actually delete. False (default) shows a preview.
confluence_list_inline_commentsA

List inline (annotation) comments on a Confluence page.

These are comments anchored to specific text selections, as opposed to
footer comments which appear at the bottom of the page.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    limit: Maximum number of comments to return (default 25, max 100).
    cursor: Pagination cursor from a previous result.
confluence_add_inline_commentA

Add an inline (annotation) comment anchored to specific text on a page.

The comment is attached to the first (or Nth) occurrence of text_selection
found in the page body.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    body: The comment text (plain text, converted to ADF paragraph).
    text_selection: The exact text on the page to attach the comment to.
    match_index: Which occurrence to annotate (0-based, default 0 = first match).
confluence_get_page_propertiesC

Get content properties on a Confluence page.

Content properties are key-value metadata pairs stored on pages.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    limit: Maximum number of properties to return (default 25, max 100).
confluence_set_page_propertyA

Set a content property on a Confluence page.

Creates the property if it doesn't exist, or updates it if it does.
The value is stored as a JSON string.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    key: The property key (e.g. "status", "priority").
    value: The property value as a JSON string (e.g. '"done"', '{"score": 5}').
confluence_copy_pageA

Copy a Confluence page.

Creates a duplicate of the page, optionally under a different parent.

Args:
    page_id: A numeric page ID or a Confluence URL (including short /wiki/x/ links).
    title: Title for the copy. Defaults to "Copy of {original title}".
    destination_parent_id: Parent page ID for the copy. Empty = same parent.
    copy_labels: Whether to copy labels (default True).
    copy_attachments: Whether to copy attachments (default True).
confluence_get_userA

Get user details by account ID.

Resolves an account ID (as seen in version history, comments, etc.)
to a display name, email, and profile info.

Args:
    account_id: The Confluence/Atlassian account ID.
confluence_list_cacheA

List all locally cached Confluence pages.

Shows page IDs, titles, and when they were last cached.

confluence_clear_cacheA

Clear the local page cache.

Removes cached page data. Pass a page_id to clear a specific page,
or omit it to clear all cached pages.

Args:
    page_id: Optional page ID to clear. Empty clears all cached pages.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/karbassi/confluence-adf-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server