Skip to main content

Confluence

Confluence is a team workspace and knowledge management tool for creating, organizing, and collaborating on documentation, meeting notes, project plans, and more.

This connector targets Confluence Cloud. For the self-hosted product, use Confluence Data Center instead. If you want Jira and Confluence together behind one server, see the official Atlassian MCP server.

Authentication Types​

  • Instant OAuth - Use Willow's pre-configured Atlassian app for the fastest setup. No app registration of your own, and each user authorizes on first connection.
    • Pros: no Atlassian admin work, working in a minute
    • Cons: consent screen and audit trail belong to Willow's app, not yours
  • OAuth - Register your own OAuth 2.0 (3LO) app in the Atlassian developer console.
    • Pros: your own consent screen, your own scope set, your own audit trail
    • Cons: needs an Atlassian admin and a few minutes of setup

Both options authorize per user, so each person sees only the spaces and pages their own Confluence account can reach. See Configure authentication for where these live on the Setup tab.

Setting up OAuth​

Use this path when the integration should run under your organization's own Atlassian app.

Create the app in Atlassian​

  1. Go to the Atlassian developer console and sign in with an account that can create apps for your site.
  2. Create a new app and enable OAuth 2.0 (3LO).
  3. Add the Confluence API to the app.
  4. Set the Callback URL to the redirect URL Willow shows on the connector's Setup tab. Copy it from Willow rather than typing it; Atlassian rejects the authorization if it does not match exactly.
  5. Under Permissions, add the granular Confluence scopes your tool selection needs. See the table below.
  6. Copy the Client ID and Secret from the app's Settings page.

Configure it in Willow​

  1. In Willow, open Build > MCP Servers > Add MCP Server, search for Confluence, and select Use.
  2. Review the risk level and tool list, then select Create.
  3. On the server's Setup tab, choose OAuth.
  4. Paste the Client ID and Client Secret, add the same scopes you granted in Atlassian, and select Save Changes.

Scopes each tool group needs​

Atlassian's granular scopes map onto the connector's tools. Grant only what your enabled tools require.

ToolsConfluence scope
Search Content, Get Page, List Pages in Space, Get Child Pagesread:page:confluence
List Spaces, Get Spaceread:space-details:confluence
Get Comments, Get Labels, Get Attachments, Download Attachmentread:content:confluence and read:content-details:confluence
Create Page, Update Page, Create Blog Post, Add Comment, Add Labels, Upload Attachmentwrite:page:confluence, write:blogpost:confluence, and write:content:confluence
Delete Pagedelete:page:confluence

Atlassian maintains the authoritative list, including scopes for whiteboards, databases, and folders that this connector does not use. See Confluence scopes for OAuth 2.0 (3LO).

Available Tools​

The connector exposes 17 tools. At the default Medium Risk level Willow enables 16 and holds back Delete Page.

Read-only​

Search Content, Get Page, List Pages in Space, List Spaces, Get Space, Get Child Pages, Get Comments, Get Labels, Get Attachments, Download Attachment

Create and update​

Create Page, Update Page, Create Blog Post, Add Comment, Add Labels, Upload Attachment

Delete​

Delete Page, classified high risk and excluded at Medium.

Troubleshooting​

The authorization redirect fails. The callback URL in the Atlassian app does not match the one on Willow's Setup tab. Copy it again from Willow, including the scheme and any trailing path.

A tool returns a permission error but the user can do it in Confluence. The app is missing the scope for that operation. Add it in the developer console, then have the user disconnect and reconnect; existing authorizations do not pick up new scopes.

Pages are missing from results. Authorization is per user, so the connector returns only what that person can already see. Check their Confluence space permissions before checking Willow.

On this page