# Atlassian Confluence Mcp Server

> MCP server for Atlassian Confluence — search, read, create and update pages via Claude / Windsurf / any MCP-compatible AI client. Supports Cloud and on-premise (Server/Data Center).

- **Type:** MCP server
- **Install:** `agentstack add mcp-anuragagrawal0430-atlassian-confluence-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [anuragagrawal0430](https://agentstack.voostack.com/s/anuragagrawal0430)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [anuragagrawal0430](https://github.com/anuragagrawal0430)
- **Source:** https://github.com/anuragagrawal0430/atlassian-confluence-mcp-server
- **Website:** https://www.npmjs.com/package/atlassian-confluence-mcp-server

## Install

```sh
agentstack add mcp-anuragagrawal0430-atlassian-confluence-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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)](https://modelcontextprotocol.io/) 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)

```bash
npx atlassian-confluence-mcp-server
```

### Global install

```bash
npm install -g atlassian-confluence-mcp-server
```

### From source

```bash
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:

```env
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:

```env
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:

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

## MCP Client Configuration

### Cloud (npx)

```json
{
  "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)

```json
{
  "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

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

### From source

```json
{
  "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

```text
# 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):

```html
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](https://modelcontextprotocol.io/)
- [Atlassian Confluence REST API](https://developer.atlassian.com/server/confluence/confluence-rest-api-examples/)

## 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](https://github.com/anuragagrawal0430)
- **Source:** [anuragagrawal0430/atlassian-confluence-mcp-server](https://github.com/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.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-anuragagrawal0430-atlassian-confluence-mcp-server
- Seller: https://agentstack.voostack.com/s/anuragagrawal0430
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.