# Confluence — MCP server on mcp.ai
> Confluence via linguagem natural: crie, busque e edite páginas, espaços e conteúdo da wiki. Plataforma fornece a aplicação OAuth, você só clica em Conectar e autoriza seu site Atlassian. Vários sites podem ser conectados no mesmo MCP.

By: mcp.ai · official
Page: https://mcp.ai/confluence

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_confluence?ms=1788959340000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/confluence/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/confluence/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/confluence/skill.md
Postman collection (v2.1): https://mcp.ai/confluence/postman.json

## Tools
- confluence_add_content_label(id: string, labels: object[]) — Tool to add labels to a piece of content. Use after obtaining the content ID to tag pages or blog posts with metadata labels.
- confluence_create_blogpost(body: object, title: string, status: string, spaceId: string) — Tool to create a new Confluence blog post. Use when you need to publish content in a specific space. Response includes `data.id` for the post ID and `data._links.base` + `data._links.webui` for the UR
- confluence_create_blogpost_property(id: string, key: string, value: string) — Tool to create a property on a specified blog post. Use when you need to add custom metadata to a blog post. Creates a new property with a key-value pair on a specified Confluence blog post. This allo
- confluence_create_content_property_for_whiteboard(key: string, value: string, whiteboard_id: string) — Tool to create a new content property on a whiteboard. Use when you need to attach custom metadata to a Confluence whiteboard.
- confluence_create_page(body?: object, title: string, spaceId: string, parentId?: string) — Tool to create a new Confluence page in a specified space. Use when you need to create new documentation or content.
- confluence_create_page_property(key: string, value: string, page_id: string) — Tool to create a property on a Confluence page. Use when you need to add custom metadata or settings to a page.
- confluence_create_private_space(key: string, name: string, description?: object) — Tool to create a private Confluence space. Use when you need an isolated workspace viewable only by its creator.
- confluence_create_space(key: string, name: string, type?: string, metadata?: string, description?: object) — Tool to create a new Confluence space. Use when setting up a new knowledge area for organization. Must include a `plain.representation` field, e.g., `{"plain": {"representation": "plain", "value": "te
- confluence_create_space_property(key: string, value: string, spaceId: string, version?: object) — Tool to create a new property on a Confluence space. Use after confirming the space ID when adding custom metadata.
- confluence_create_whiteboard(title?: string, spaceId: string, parentId?: string) — Tool to create a new Confluence whiteboard. Use when you need to start a collaborative whiteboard session.
- confluence_delete_blogpost_property(id: string, propertyId: string) — Tool to delete a blog post property. Use when you need to remove custom metadata from a specified blog post.
- confluence_delete_content_property_for_page_by_id(pageId: string, propertyId: string) — Tool to delete a content property from a page by property ID. Use when you need to remove custom metadata from a page for cleanup or auditing. This action deletes a specified content property from a C
- confluence_delete_content_property_for_whiteboard_by_id(propertyId: string, whiteboardId: string) — Tool to delete a content property from a whiteboard by property ID. Use when you need to remove custom metadata from a whiteboard.
- confluence_delete_page(id: string) — Tool to delete a Confluence page. Use with caution as this permanently removes the page and its content with no recovery option. In move or migration workflows, confirm all target pages were successfu
- confluence_delete_space(space_key: string) — Tool to delete a Confluence space by its key. Use when you need to permanently remove a space. Deletion runs as an asynchronous long-running task; this action waits (briefly) for it to finish and repo
- confluence_delete_space_property(propertyId: string, spaceIdOrKey: string) — Tool to delete a space property. Use when you need to remove a property from a Confluence space after review.
- confluence_get_attachment_labels(id: string, sort?: string, limit?: integer, cursor?: string, prefix?: string) — Tool to list labels on an attachment. Use after confirming the attachment ID to fetch its labels.
- confluence_get_attachments(limit?: integer, cursor?: string, pageId: string, mediaType?: string) — Tool to retrieve attachments of a Confluence page. Use after confirming page ID to list its attachments (supports pagination).
- confluence_get_audit_logs(limit?: integer, start?: integer, endDate?: integer, startDate?: integer, searchString?: string) — Tool to retrieve Confluence audit records. Use when you need to fetch and filter audit logs for compliance or troubleshooting.
- confluence_get_blog_posts(limit?: integer, cursor?: string) — Tool to retrieve a list of blog posts. Use when you need a paginated list of Confluence blog posts.
- confluence_get_blog_posts_for_label(id: string, limit?: integer, cursor?: string) — Tool to list all blog posts under a specific label. Use when you have a label ID and need to retrieve associated blog posts.
- confluence_get_blogpost_by_id(id: string) — Tool to retrieve a specific Confluence blog post by its ID. Use when you have a blog post ID and need detailed metadata and content.
- confluence_get_blogpost_labels(id: string, limit?: integer, cursor?: string) — Tool to retrieve labels of a specific Confluence blog post by ID. Use after obtaining the blog post ID to list its labels.
- confluence_get_blogpost_like_count(id: string) — Tool to get like count for a Confluence blog post. Use after confirming the blog post ID to retrieve total likes.
- confluence_get_blogpost_operations(id: string) — Tool to retrieve permitted operations for a Confluence blog post. Use after confirming the blog post ID to see allowed actions.
- confluence_get_blogpost_version_details(blogpostId: string, versionNumber: integer) — Tool to retrieve details for a specific version of a blog post. Use when you have a blogpostId and versionNumber and need detailed metadata for that version.
- confluence_get_blogpost_versions(limit?: integer, cursor?: string, blogpostId: string) — Tool to retrieve all versions of a specific blog post. Use when you have a blogpostId and need to list version numbers.
- confluence_get_child_pages(id: string, sort?: string, limit?: integer, cursor?: string) — Tool to list all direct child pages of a given Confluence page. Use when you have a parent page ID and need to discover its direct descendants. Response nests child page data under `data.data.results`
- confluence_get_content_properties_for_blog_post(limit?: integer, cursor?: string, blogpost_id: string) — Tool to retrieve all content properties on a blog post. Use when you need to list metadata properties set on a specific Confluence blog post.
- confluence_get_content_properties_for_page(limit?: integer, cursor?: string, page_id: string) — Tool to retrieve all content properties on a page. Use when you need to list metadata properties set on a specific Confluence page.
- confluence_get_content_restrictions(id: string, expand?: string[]) — Tool to retrieve restrictions on a Confluence content item. Use when you need to see who can view or edit a page or blog post.
- confluence_get_current_user() — Tool to get information about the currently authenticated user — always scoped to the account tied to the configured connection, not arbitrary users. Use CONFLUENCE_SEARCH_USERS to look up other users
- confluence_get_inline_comments_for_blog_post(id: string, sort?: string, limit?: integer, cursor?: string, body_format?: string) — Tool to retrieve inline comments for a Confluence blog post. Use when you need inline comment details by blog post ID.
- confluence_get_labels(limit?: integer, cursor?: string) — Tool to retrieve all labels in a Confluence site; use for label discovery when you need to list or page through labels. For label-based filtering, use CONFLUENCE_GET_LABELS_FOR_PAGE or CONFLUENCE_GET_
- confluence_get_labels_for_page(id: string, limit?: integer, cursor?: string) — Tool to retrieve labels of a specific Confluence page by ID. Labels are returned in `data.results[*].name` and are not available in CONFLUENCE_GET_PAGES responses. Use after obtaining the page ID to l
- confluence_get_labels_for_space(id: string, sort?: string, limit?: integer, cursor?: string, prefix?: string) — Tool to list labels on a space. Use when you need to retrieve labels for a specific space.
- confluence_get_labels_for_space_content(id: string, limit?: integer, cursor?: string, prefix?: string) — Tool to list labels on all content in a space. Use when you need to retrieve or filter content labels by space, with pagination and optional prefix filtering. For label discovery across a space before
- confluence_get_page_ancestors(id: string, limit?: integer) — Tool to retrieve all ancestors for a given Confluence page by its ID. Use when you need the full page hierarchy.
- confluence_get_page_by_id(id: string, draft?: boolean, version?: integer) — Tool to retrieve a Confluence page by its ID. Use when you have a page ID and need its detailed metadata and content. Response body is in `body.storage.value` as Confluence storage format (HTML); stri
- confluence_get_page_like_count(id: string) — Tool to get like count for a Confluence page. Use after confirming the page ID to retrieve total likes.
- confluence_get_page_versions(id: string, limit?: integer, cursor?: string) — Tool to retrieve all versions of a specific Confluence page. Use to audit edit history or to get the latest version.number before calling CONFLUENCE_UPDATE_PAGE — using a stale version.number causes a
- confluence_get_pages(sort?: string, limit?: integer, title?: string, cursor?: string, status?: string|string[], subtype?: string, space_id?: string|string[], body_format?: string) — Tool to retrieve a paginated list of Confluence pages. Results are permission-scoped to the authenticated user; empty results may reflect access restrictions. Omitting filters like spaceId or status c
- confluence_get_space_by_id(id: string) — Tool to retrieve a Confluence space by its ID. Use when you need detailed metadata of a specific space. Space names are non-unique; use the numeric spaceId or spaceKey from the response for stable ide
- confluence_get_space_contents(type?: string, limit?: integer, cursor?: string, status?: string, spaceKey: string) — Tool to retrieve content in a Confluence space. Use when you need to list pages or blogposts of a specific space key. Results are in data.results; follow response._links.next (cursor pagination) until
- confluence_get_space_properties(id: string, key?: string[], limit?: integer, cursor?: string) — Tool to get properties of a Confluence space. Use when you need to retrieve custom metadata or settings stored as space properties.
- confluence_get_spaces(type?: string, label?: string[], limit?: integer, cursor?: string, expand?: string[], status?: string, spaceKey?: string[]) — Tool to retrieve a paginated list of Confluence spaces with optional filtering. Paginate with `cursor`: pass the token from `data._links.next` (or the full next URL) as `cursor` to fetch the next page
- confluence_get_user_anonymous() — Tool to retrieve information about the anonymous user. Use when you need to obtain guest user details before unauthenticated interactions.
- confluence_search_content(limit?: integer, query: string, start?: integer, cursor?: string, expand?: string, spaceKey?: string) — Searches one page of content from the Confluence v2 API with intelligent title ranking. Call this action again with the cursor from `_links.next` to search the next page. Since the native search endpo
- confluence_search_users(limit?: integer, start?: integer, accountId?: string) — Searches for users using user-specific queries from the Confluence Query Language (CQL).
- confluence_update_blogpost(id: string, body: object, title: string, status?: string, spaceId: string, version: object) — Tool to update a Confluence blog post's title or content. Use when you need to modify an existing blog post. Ensure you have the latest version number before calling.
- confluence_update_blogpost_property(id: string, value: string, propertyId: string) — Tool to update a property of a specified blog post. Use when you need to modify custom metadata on a blog post.
- confluence_update_content_property_for_page_by_id(value: string, pageId: string, propertyId: string) — Tool to update a content property on a Confluence page. Use when you need to modify an existing metadata property by its ID.
- confluence_update_content_property_for_whiteboard_by_id(value: string, propertyId: string, whiteboardId: string) — Tool to update a content property on a whiteboard. Use when you need to modify metadata on a Confluence whiteboard.
- confluence_update_page(id: string, body: object, title: string, spaceId?: string, version: object) — Tool to update an existing Confluence page, replacing the entire page content. Use when you need to modify existing documentation or content.
- confluence_update_space_property(value: string, spaceId: string, propertyId: string) — Tool to update a space property. Use when you need to modify custom metadata stored on a Confluence space (requires fetching the current property version first).

## Example prompts
- "Crie uma página 'Onboarding' no espaço da Engenharia"
- "Busque páginas que mencionam 'política de férias'"
- "Liste as páginas atualizadas esta semana no espaço de Produto"

## Links
Docs: https://mcp.ai/docs/mcps/confluence
Website: https://mcp.ai/mcps/confluence