Atlassian Confluence Mcp Server

Atlassian Confluence MCP Server

[](https://github.com/anuragagrawal0430/atlassian-confluence-mcp-server/actions) [](https://badge.fury.io/js/atlassian-confluence-mcp-server) [](https://www.npmjs.com/package/atlassian-confluence-mcp-server) [](https://opensource.org/licenses/MIT)

An open-source Model Context Protocol (MCP) server for Atlassian Confluence that lets AI assistants like Claude and Windsurf read, create, search, and manage Confluence wiki pages. Works with Confluence Cloud, on-premise Server, and Data Center deployments — connect your AI coding agent to your team's knowledge base in seconds via npx.

Why atlassian-confluence-mcp-server?

• ✅ Only MCP server supporting Cloud + Server + Data Center in one package
• ✅ 42 tools — most comprehensive Confluence MCP available
• ✅ Zero config via npx — no install needed
• ✅ PAT, Basic Auth, and API token support
• ✅ Actively maintained with provenance-signed releases

Why use this instead of Atlassian's official MCP server?

| Feature | This package | Atlassian Official | |---|---|---| | Confluence Cloud | ✅ | ✅ | | On-premise Server | ✅ | ❌ | | Data Center | ✅ | ❌ | | Zero config via npx | ✅ | ❌ | | 42 tools | ✅ | ~15 tools | | Space management (create/delete) | ✅ | ❌ | | Page copy/move | ✅ | ❌ | | Watchers | ✅ | ❌ | | Permissions/restrictions | ✅ | ❌ | | Task extraction | ✅ | ❌ | | Export (PDF/Word) | ✅ | ❌ | | Open source | ✅ MIT | ✅ | | Works offline/intranet | ✅ | ❌ |

Features

• Space Management — Create, delete, list, and inspect spaces
• Page CRUD — Create, read, update, delete, copy, and move pages
• Search — Full CQL and text search, recently modified pages
• Labels — Add, list, and remove page labels
• Comments — Read and post page comments
• Attachments — List page and comment attachments
• Page Hierarchy — Navigate parent/child relationships
• Version History — Browse and inspect page versions
• Watchers — View and manage page watchers
• Permissions — Get and set page restrictions
• Tasks — Extract inline tasks from pages
• Export — Generate PDF/Word export URLs
• Personal Space — Create pages in your personal space
• URL Parsing — Retrieve page content from a Confluence URL

Prerequisites

• Node.js 18+
• A Confluence instance (Cloud or Server/Data Center 7.9+)
• Authentication credentials (PAT or username/password)

Installation

Via npx (no install required)

npx atlassian-confluence-mcp-server

Global install

npm install -g atlassian-confluence-mcp-server

From source

git clone https://github.com/anuragagrawal0430/atlassian-confluence-mcp-server.git
cd atlassian-confluence-mcp-server
npm install
npm run build

Configuration

All configuration is passed through environment variables. Never hard-code credentials.

| Variable | Required | Description | |---|---|---| | CONFLUENCE_BASE_URL | Yes | Root URL of your Confluence instance | | PAT | See below | API token (Cloud) or Personal Access Token (Server/DC) | | CONFLUENCE_USERNAME | Cloud only | Your Atlassian account email | | CONFLUENCE_PASSWORD | Alt auth | Password or API token for Basic Auth |

Confluence Cloud

Cloud API tokens are generated from your Atlassian account and require both your email and the token:

CONFLUENCE_BASE_URL=https://your-site.atlassian.net
CONFLUENCE_USERNAME=you@example.com
PAT=your-api-token

1. Go to
2. Click Create API token, give it a label, and copy the value
3. Set CONFLUENCE_USERNAME to your Atlassian account email
4. Set PAT to the copied API token

Confluence Server / Data Center (7.9+)

Server and Data Center instances use a Personal Access Token with Bearer authentication. Only the token is needed:

CONFLUENCE_BASE_URL=https://confluence.example.com
PAT=your-personal-access-token

1. Navigate to Profile > Settings > Personal Access Tokens
2. Create a token with the required permissions
3. Copy the token value

Basic Authentication (fallback)

For older Server versions without PAT support, use username/password:

CONFLUENCE_BASE_URL=https://confluence.example.com
CONFLUENCE_USERNAME=your-username
CONFLUENCE_PASSWORD=your-password

MCP Client Configuration

Cloud (npx)

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["-y", "atlassian-confluence-mcp-server"],
      "env": {
        "CONFLUENCE_BASE_URL": "https://your-site.atlassian.net",
        "CONFLUENCE_USERNAME": "you@example.com",
        "PAT": "your-api-token"
      }
    }
  }
}

Server / Data Center (npx)

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["-y", "atlassian-confluence-mcp-server"],
      "env": {
        "CONFLUENCE_BASE_URL": "https://confluence.example.com",
        "PAT": "your-personal-access-token"
      }
    }
  }
}

Global install

{
  "mcpServers": {
    "confluence": {
      "command": "atlassian-confluence-mcp-server",
      "env": {
        "CONFLUENCE_BASE_URL": "https://confluence.example.com",
        "PAT": "your-personal-access-token"
      }
    }
  }
}

From source

{
  "mcpServers": {
    "confluence": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "CONFLUENCE_BASE_URL": "https://confluence.example.com",
        "PAT": "your-personal-access-token"
      }
    }
  }
}

Available Tools (42)

Connection

| Tool | Description | |------|-------------| | confluence_test_connection | Test connection to Confluence API |

Spaces

| Tool | Description | |------|-------------| | confluence_get_spaces | List all spaces | | confluence_get_space | Get space details by key | | confluence_get_space_by_key | Alias for get_space | | confluence_create_space | Create a new space | | confluence_delete_space | Delete a space and all its content | | confluence_get_space_homepage | Get the homepage of a space |

Pages

| Tool | Description | |------|-------------| | confluence_get_pages | List pages, optionally filtered by space | | confluence_get_page | Get page by ID | | confluence_get_page_by_title | Get page by title within a space | | confluence_create_page | Create a new page | | confluence_update_page | Update an existing page | | confluence_delete_page | Delete a page | | confluence_copy_page | Copy a page, optionally to a different space | | confluence_move_page | Move a page to a different parent or space |

Search

| Tool | Description | |------|-------------| | confluence_search | Search using CQL | | confluence_search_pages | Search pages by text | | confluence_get_recently_modified | Get recently modified pages |

Labels

| Tool | Description | |------|-------------| | confluence_get_page_labels | Get labels on a page | | confluence_add_page_label | Add a label to a page | | confluence_delete_page_label | Remove a label from a page |

Comments

| Tool | Description | |------|-------------| | confluence_get_page_comments | Get comments on a page | | confluence_add_page_comment | Add a comment to a page |

Attachments

| Tool | Description | |------|-------------| | confluence_get_page_attachments | List attachments on a page | | confluence_get_comment_attachments | List attachments on a comment |

Page Hierarchy

| Tool | Description | |------|-------------| | confluence_get_child_pages | Get child pages of a parent | | confluence_get_page_ancestors | Get ancestor pages |

Version History

| Tool | Description | |------|-------------| | confluence_get_page_versions | Get page version history | | confluence_get_page_version | Get a specific page version |

Properties

| Tool | Description | |------|-------------| | confluence_get_page_properties | Get content properties of a page |

User

| Tool | Description | |------|-------------| | confluence_get_current_user | Get current authenticated user |

Watchers

| Tool | Description | |------|-------------| | confluence_get_page_watchers | Get users watching a page | | confluence_watch_page | Add current user as a watcher | | confluence_unwatch_page | Remove current user as a watcher |

Permissions

| Tool | Description | |------|-------------| | confluence_get_page_permissions | Get page restrictions/permissions | | confluence_set_page_permissions | Set page restrictions/permissions |

Tasks

| Tool | Description | |------|-------------| | confluence_get_page_tasks | Extract inline tasks from a page |

Export

| Tool | Description | |------|-------------| | confluence_export_page | Get export URL for a page (PDF or Word) |

Utilities

| Tool | Description | |------|-------------| | confluence_get_page_by_url | Get page from a Confluence URL |

Personal Space

| Tool | Description | |------|-------------| | confluence_get_personal_space_key | Get current user's personal space key | | confluence_create_page_in_personal_space | Create page in personal space | | confluence_create_private_space | Create a private space |

Resources

| URI | Description | |-----|-------------| | confluence://spaces | List of all Confluence spaces |

Example CQL Queries

# Pages in a specific space
type=page AND space=TEAM

# Pages with a label
type=page AND label=documentation

# Recently modified pages
type=page AND lastModified > now("-7d")

# Title search
type=page AND title~"Meeting Notes"

# Pages created by current user
type=page AND creator=currentUser()

Page Body Format

Pages use Confluence storage format (XHTML):

This is a paragraph.
Heading 1

  Item 1
  Item 2

  javascript
  

Security

• Credentials are read exclusively from environment variables — never hard-coded.
• Input validation — all user-supplied parameters are validated and sanitized before use.
• CQL injection prevention — user input interpolated into CQL queries is escaped.
• URL path encoding — all dynamic path segments are encoded with encodeURIComponent.
• Request timeouts — all HTTP requests have a 30-second timeout to prevent hanging.
• Error sanitization — API error responses are truncated and stripped of HTML before surfacing.
• Pagination limits — query limits are clamped to a safe maximum (100) to prevent abuse.

Contributing

Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to contribute to this project.

Security Policy

For security policies and vulnerability reporting, see [SECURITY.md](SECURITY.md).

Changelog

See [CHANGELOG.md](CHANGELOG.md) for a history of changes.

License

[MIT](LICENSE)

Acknowledgments

• Model Context Protocol
• Atlassian Confluence REST API

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: anuragagrawal0430
• Source: anuragagrawal0430/atlassian-confluence-mcp-server
• License: MIT
• Homepage: https://www.npmjs.com/package/atlassian-confluence-mcp-server

Install and usage instructions live in the source repository linked above.