Metadata-Version: 2.4
Name: confluence-cloud-mcp
Version: 0.1.1
Summary: Confluence MCP Server for Claude Code — page CRUD, section editing, table management, smart updates, and more
Project-URL: Repository, https://github.com/socar-edwin/confluence-cloud-mcp
Author: Edwin Park
License-Expression: MIT
License-File: LICENSE
Keywords: atlassian,claude,confluence,mcp,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: markdown>=3.5.0
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# confluence-cloud-mcp

Confluence Cloud MCP server for [Claude Code](https://claude.ai/code).

The official Atlassian connector covers basic page read/write. This server adds **27 tools** including section-level editing, table CRUD, smart diff updates, attachments, and space export.

## Install (1 minute)

### Option A: Interactive setup

```bash
uvx confluence-cloud-mcp --setup
```

Asks for your Confluence URL, email, and API token, then auto-registers with Claude Code.

### Option B: One-liner

```bash
claude mcp add confluence -s user \
  -e "CONFLUENCE_URL=https://yourcompany.atlassian.net" \
  -e "CONFLUENCE_EMAIL=you@company.com" \
  -e "CONFLUENCE_API_TOKEN=your-token" \
  -- uvx confluence-cloud-mcp
```

### API Token

1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
2. Click **Create API token**
3. Copy the token

## Tools (27)

### Page Management
| Tool | Description |
|------|-------------|
| `list_spaces` | List accessible spaces |
| `get_page` | Get page by ID or URL |
| `get_page_full` | Get full page content with formatting |
| `create_page` | Create new page |
| `update_page` | Update existing page |
| `append_to_page` | Append content to page |
| `search_pages` | Search pages by keyword |

### Section Editing
| Tool | Description |
|------|-------------|
| `list_page_sections` | List all headings in a page |
| `update_page_section` | Update a specific section by heading |
| `smart_update_page` | Diff-aware update (skip if unchanged) |

### Table Operations
| Tool | Description |
|------|-------------|
| `get_page_tables` | Extract tables from page |
| `update_page_table` | Modify table content |
| `add_table_row` | Add row to table |
| `delete_table_row` | Delete row from table |
| `update_table_cell` | Update specific cell |
| `create_page_with_table` | Create page with table |

### Attachments & Export
| Tool | Description |
|------|-------------|
| `upload_attachment` | Upload file to page |
| `upload_attachments` | Upload multiple files |
| `download_page_images` | Download all images |
| `download_page_attachments` | Download all attachments |
| `export_page` | Export page to Markdown |
| `export_space` | Export space to Markdown files |
| `sync_space` | Sync space to local filesystem |

### Database
| Tool | Description |
|------|-------------|
| `list_databases` | List Confluence databases |
| `get_database` | Get database metadata |
| `create_database` | Create database |
| `delete_database` | Delete database |

## Markdown Support

Write content in Markdown — it auto-converts to Confluence Storage Format.

Supported: headings, bold/italic, lists, tables, code blocks, links, images, horizontal rules.

## Requirements

- Python 3.10+
- Confluence Cloud (Atlassian hosted)
- API token with read/write access

## License

MIT
