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

Related MCP server: MCP Atlassian Server

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="your_email@example.com"
export CONFLUENCE_CLOUD_ID="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Reload your shell or open a new terminal.

*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.

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.

confluence.fetch_image

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

confluence.compare

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

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