# Confluence Cloud MCP server

> Enables AI clients to manage Confluence Cloud content through structured page editing, space management, media handling, and graph-based navigation.

- Repository: https://github.com/aaronsb/confluence-cloud
- Page: https://hostedmcp.org/servers/aaronsb/confluence-cloud
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.6.0

## Install

### Claude Code

```sh
claude mcp add --env 'CONFLUENCE_API_TOKEN=<YOUR_CONFLUENCE_API_TOKEN>' --env 'CONFLUENCE_EMAIL=<CONFLUENCE_EMAIL>' --env 'CONFLUENCE_HOST=<CONFLUENCE_HOST>' confluence-cloud -- npx -y @aaronsb/confluence-cloud-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "confluence-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@aaronsb/confluence-cloud-mcp"
      ],
      "env": {
        "CONFLUENCE_API_TOKEN": "<YOUR_CONFLUENCE_API_TOKEN>",
        "CONFLUENCE_EMAIL": "<CONFLUENCE_EMAIL>",
        "CONFLUENCE_HOST": "<CONFLUENCE_HOST>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "confluence-cloud": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@aaronsb/confluence-cloud-mcp"
      ],
      "env": {
        "CONFLUENCE_API_TOKEN": "<YOUR_CONFLUENCE_API_TOKEN>",
        "CONFLUENCE_EMAIL": "<CONFLUENCE_EMAIL>",
        "CONFLUENCE_HOST": "<CONFLUENCE_HOST>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"confluence-cloud","type":"stdio","command":"npx","args":["-y","@aaronsb/confluence-cloud-mcp"],"env":{"CONFLUENCE_API_TOKEN":"<YOUR_CONFLUENCE_API_TOKEN>","CONFLUENCE_EMAIL":"<CONFLUENCE_EMAIL>","CONFLUENCE_HOST":"<CONFLUENCE_HOST>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "confluence-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@aaronsb/confluence-cloud-mcp"
      ],
      "env": {
        "CONFLUENCE_API_TOKEN": "<YOUR_CONFLUENCE_API_TOKEN>",
        "CONFLUENCE_EMAIL": "<CONFLUENCE_EMAIL>",
        "CONFLUENCE_HOST": "<CONFLUENCE_HOST>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add confluence-cloud --env 'CONFLUENCE_API_TOKEN=<YOUR_CONFLUENCE_API_TOKEN>' --env 'CONFLUENCE_EMAIL=<CONFLUENCE_EMAIL>' --env 'CONFLUENCE_HOST=<CONFLUENCE_HOST>' -- npx -y @aaronsb/confluence-cloud-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.confluence-cloud]
command = "npx"
args = ["-y", "@aaronsb/confluence-cloud-mcp"]

[mcp_servers.confluence-cloud.env]
CONFLUENCE_API_TOKEN = "<YOUR_CONFLUENCE_API_TOKEN>"
CONFLUENCE_EMAIL = "<CONFLUENCE_EMAIL>"
CONFLUENCE_HOST = "<CONFLUENCE_HOST>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'CONFLUENCE_API_TOKEN=<YOUR_CONFLUENCE_API_TOKEN>' -e 'CONFLUENCE_EMAIL=<CONFLUENCE_EMAIL>' -e 'CONFLUENCE_HOST=<CONFLUENCE_HOST>' confluence-cloud npx -- -y @aaronsb/confluence-cloud-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "confluence-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@aaronsb/confluence-cloud-mcp"
      ],
      "env": {
        "CONFLUENCE_API_TOKEN": "<YOUR_CONFLUENCE_API_TOKEN>",
        "CONFLUENCE_EMAIL": "<CONFLUENCE_EMAIL>",
        "CONFLUENCE_HOST": "<CONFLUENCE_HOST>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CONFLUENCE_API_TOKEN` | yes | yes | Confluence API token (generate at https://id.atlassian.com/manage/api-tokens) |
| `CONFLUENCE_EMAIL` | yes | no | Atlassian account email address |
| `CONFLUENCE_HOST` | yes | no | Confluence instance URL (e.g., https://your-team.atlassian.net) |

## Tools (7)

- `manage_confluence_page`
- `edit_confluence_content`
- `manage_confluence_space`
- `search_confluence`
- `manage_confluence_media`
- `navigate_confluence`
- `queue_confluence_operations`

## FAQ

### What credentials are required to use the server?

You need an Atlassian API token, your email address, and your Confluence host URL.

### Does the server support editing specific parts of a page?

Yes, it features session-based editing that allows for surgical edits to individual blocks like sections, paragraphs, macros, and tables without rewriting the entire page.

### How are links and relationships discovered in Confluence?

The server uses the Atlassian GraphQL gateway's link graph for fast and accurate discovery of backlinks and forward links.
