Confluence MCP server

Connect Confluence to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Confluence MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get current user tool in Confluence
  • Use the get page tool in Confluence
  • Use the delete blog post tool in Confluence
  • Use the get labels tool in Confluence
  • Use the list blog posts tool in Confluence
  • Use the update page tool in Confluence

Supported Tools

get_current_user

Get Current User

Retrieve the currently authenticated Confluence user's profile information.

get_page

Get Page

Retrieve a Confluence page by its ID, with optional body content. Returns page metadata including title, space, version, and status. Use **includeBody** to fetch the full storage-format content.

delete_blog_post

Delete Blog Post

Delete a Confluence blog post by ID (moves to trash).

get_labels

Get Labels

Get all labels on a Confluence content item (page, blog post, or attachment).

list_blog_posts

List Blog Posts

List Confluence blog posts, optionally filtered by space or title. Returns blog post metadata for each result.

update_page

Update Page

Update an existing Confluence page's title, body, or status. Requires the current version number to prevent conflicts. If you don't know the current version, use **Get Page** first to retrieve it.

create_blog_post

Create Blog Post

Create a new blog post in a Confluence space. The body should be in Confluence storage format (XHTML-based).

delete_comment

Delete Comment

Delete a footer comment by ID.

search_content

Search Content

Search Confluence content. Use query for plain-text searches, or cql for advanced Confluence Query Language filters. CQL supports filtering by type, space, label, creator, date, title, text content, and more. **Example CQL queries:** - `type=page AND space=DEV` — all pages in the DEV space - `text ~ "release notes"` — content containing "release notes" - `label=important AND type=blogpost` — blog posts with the "important" label - `creator=currentUser() AND lastModified > now("-7d")` — your recent content

get_page_properties

Get Page Properties

Retrieve all content properties (key-value metadata) for a Confluence page.

get_attachments

Get Attachments

List file attachments on a Confluence page or blog post. Returns attachment metadata including file name, media type, size, and download link.

get_comments

Get Comments

Retrieve footer comments on a Confluence page. Returns comment metadata and body content.

add_comment

Add Comment

Add a footer comment to a Confluence page or blog post. The body should be in Confluence storage format.

list_groups

List Groups

List Confluence groups with pagination support.

set_page_property

Set Page Property

Create or update a content property (key-value metadata) on a Confluence page. If updating, provide the property ID and current version number.

get_content_restrictions

Get Content Restrictions

Get read and update restrictions on a Confluence content item. Shows which users and groups have restricted access.

delete_page_property

Delete Page Property

Delete a content property from a Confluence page.

add_labels

Add Labels

Add one or more labels to a Confluence content item (page, blog post, or attachment). Labels are useful for categorization and discovery.

get_space

Get Space

Retrieve a single Confluence space by its ID. Returns space metadata.

get_content_versions

Get Content Versions

Retrieve the version history of a Confluence page or blog post. Shows who made changes, when, and their version messages.

list_pages

List Pages

List Confluence pages, optionally filtered by space, title, or status. Returns page metadata for each result. Supports pagination via cursor.

create_page

Create Page

Create a new Confluence page in a specified space. The body should be in Confluence storage format (XHTML-based). Optionally set a parent page to create hierarchical content.

list_spaces

List Spaces

List Confluence spaces with optional filtering by space key, type, or status. Returns space metadata including name, key, and type.

remove_content_restrictions

Remove Content Restrictions

Remove all restrictions from a Confluence content item, making it accessible according to space-level permissions.

remove_label

Remove Label

Remove a label from a Confluence content item.

get_blog_post

Get Blog Post

Retrieve a single Confluence blog post by ID with optional body content.

delete_page

Delete Page

Delete a Confluence page by ID. The page is moved to trash and can be restored later.

update_blog_post

Update Blog Post

Update an existing Confluence blog post's title, body, or status. Requires the current version number.

get_page_children

Get Page Children

Retrieve the direct child pages of a Confluence page. Useful for navigating the page hierarchy.

update_content_restrictions

Update Content Restrictions

Set read or update restrictions on a Confluence content item. Controls which users and groups can view or edit the content.

upload_attachment

Upload Attachment

Upload a file attachment to a Confluence page or blog post from base64-encoded content. Can create a new attachment or update an existing attachment with the same file name.

delete_attachment

Delete Attachment

Delete a Confluence attachment by ID. By default the attachment is moved to trash; purge permanently deletes a trashed attachment.

get_attachment

Get Attachment

Retrieve a Confluence attachment by ID, including file metadata and its API download link when available.

Connect Confluence to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Confluence in Metorial. In your Metorial portal, enable the Confluence MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Confluence tools.

Run Confluence through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Confluence and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Confluence tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Confluence

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

Google Sheets

Create, read, and update spreadsheets and their cell data. Read and write values to individual cells, ranges, or multiple ranges using A1 notation or named ranges. Apply cell formatting including text styles, backgrounds, borders, number formats, and conditional formatting. Manage sheets (tabs) within a spreadsheet—add, delete, copy, rename, and reorder them. Create and manage embedded charts, pivot tables, filter views, data validation rules, protected ranges, named ranges, and merged cells. Perform batch operations to apply multiple updates atomically.

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Gmail

Send, read, and search email messages with support for recipients, attachments, and HTML content. Create, update, and send drafts. Manage conversation threads and organize messages with labels. Search mailboxes using Gmail query syntax (from, to, subject, date, attachment filters). Manage filters and vacation responders, update the primary address's display name and signature, and view send-as aliases, forwarding addresses, and auto-forwarding status. Import and insert messages for migration.

Technical notes for Confluence

Create, read, update, and delete pages, blog posts, comments, and attachments in Confluence spaces. Manage spaces, permissions, labels, and content restrictions. Search content using Confluence Query Language (CQL). Upload and download file attachments with versioning. Manage users, groups, and group memberships. Create and manage whiteboards, databases, folders, and templates. View and update inline tasks. Access audit logs.

Frequently asked questions

Common questions about connecting Confluence to AI agents with Metorial.

  1. How many tools does the Confluence MCP server have?
    The Confluence MCP server exposes 33 tools, including Get Current User, Get Page, Delete Blog Post. Each one is governed and traced through Metorial.
  2. Confluence exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Confluence MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Confluence and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Confluence MCP server yourself or use the hosted gateway.

Connect Confluence to production AI agents

See how Metorial gives your team governed access to Confluence, with tracing and security controls built in.