Confluence Reader MCP Server

An MCP server that lets AI assistants read Confluence Cloud pages as markdown, browse page trees, download image attachments, and diff content against local documentation.

Features

• Fetch a single Confluence page as proper GitHub-flavored markdown (headings, tables, lists, code blocks)
• List child pages for recursive traversal
• Download image attachments by filename
• Compare local content against a Confluence page with a unified diff
• Supports scoped API tokens with Basic Auth

Setup

1. Get a Confluence API Token

Create a scoped API token from your Atlassian account: https://support.atlassian.com/confluence/kb/scoped-api-tokens-in-confluence-cloud/

2. Set Environment Variables

Add to your shell profile (~/.zshrc, ~/.bashrc, etc.):

export CONFLUENCE_TOKEN="your_scoped_token"
export CONFLUENCE_EMAIL="[email protected]"
export CONFLUENCE_CLOUD_ID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Reload your shell or open a new terminal.

| Variable | Required | Description | |----------|----------|-------------| | CONFLUENCE_TOKEN | Yes | Scoped API token | | CONFLUENCE_EMAIL | Yes | Email tied to your Atlassian account | | CONFLUENCE_CLOUD_ID | Yes* | Cloud ID — routes via api.atlassian.com | | CONFLUENCE_BASE_URL | Yes* | Direct tenant URL, e.g. https://your-org.atlassian.net |

*One of CONFLUENCE_CLOUD_ID or CONFLUENCE_BASE_URL is required. CONFLUENCE_CLOUD_ID is recommended.

3. Add to MCP Config

{
  "mcpServers": {
    "confluence-reader": {
      "command": "npx",
      "args": ["@satiyap/confluence-reader-mcp"]
    }
  }
}

Restart the MCP host to pick up the new server.

Tools

confluence.fetch_page

Fetches a single Confluence page by URL and returns its content as markdown. Lists any direct child pages at the bottom so the caller can decide which to fetch next.

| Parameter | Type | Description | |-----------|------|-------------| | url | string | Confluence page URL |

confluence.list_children

Lists the direct child pages of a Confluence page without fetching their content. Useful for discovering page structure before fetching individual pages.

| Parameter | Type | Description | |-----------|------|-------------| | url | string | Confluence page URL |

confluence.fetch_image

Downloads an image attachment from a Confluence page by filename and saves it to a local directory.

| Parameter | Type | Description | |-----------|------|-------------| | url | string | Confluence page URL | | filename | string | Attachment filename (e.g. architecture.png) | | destination | string | Local directory path to save the image to |

confluence.compare

Generates a git-style unified diff between a Confluence page and a local markdown string.

| Parameter | Type | Description | |-----------|------|-------------| | url | string | Confluence page URL | | localContent | string | Local markdown to compare against |

Returns a JSON object with additions, deletions, totalChanges, and the full diff.

Supported URL Formats

• /wiki/spaces/SPACEKEY/pages/123456789/Page+Title
• /wiki/pages/viewpage.action?pageId=123456789

Security

• Credentials are read from environment variables only — never passed in config files.
• Use scoped tokens with the minimum permissions needed.

Contributing

Contributions are welcome. Please open an issue or submit a pull request.

License

MIT