# Confluence MCP Server
A Model Context Protocol (MCP) server for integrating AI assistants with Atlassian Confluence Cloud.
## Features
- **Create pages** - Create new pages with Markdown content
- **Update pages** - Modify existing pages
- **Read pages** - Retrieve page content by ID
- **Search pages** - Find pages by title
- **List pages** - List all pages in a space
- **Delete pages** - Remove pages from Confluence
## Installation
### Option 1: From Source
```bash
git clone https://github.com/anu-june/confluence-mcp-server.git
cd confluence-mcp-server
npm install
```
### Option 2: Global Install (after publishing to npm)
```bash
npm install -g @anu-june/confluence-mcp-server
```
## Configuration
### Environment Variables
| Variable | Description | Required |
|----------|-------------|----------|
| `CONFLUENCE_URL` | Your Confluence instance URL (e.g., `https://yourname.atlassian.net`) | ✅ |
| `CONFLUENCE_EMAIL` | Your Atlassian account email | ✅ |
| `CONFLUENCE_API_TOKEN` | Your Confluence API token ([Generate here](https://id.atlassian.com/manage-profile/security/api-tokens)) | ✅ |
| `CONFLUENCE_SPACE_KEY` | Default space key (optional, can be passed per-tool) | ❌ |
### IDE Configuration
Add to your MCP settings (VS Code, Cursor, Antigravity, etc.):
```json
{
"mcpServers": {
"confluence": {
"command": "node",
"args": ["/path/to/confluence-mcp-server/src/index.js"],
"env": {
"CONFLUENCE_URL": "https://yourname.atlassian.net",
"CONFLUENCE_EMAIL": "your@email.com",
"CONFLUENCE_API_TOKEN": "your_api_token"
}
}
}
}
```
## Available Tools
| Tool | Description | Parameters |
|------|-------------|------------|
| `create_confluence_page` | Create a new page | `spaceKey`, `title`, `content`, `parentId?` |
| `update_confluence_page` | Update an existing page | `pageId`, `title`, `content` |
| `get_confluence_page` | Get page content by ID | `pageId` |
| `search_confluence_pages` | Search pages by title | `spaceKey`, `query` |
| `list_confluence_pages` | List all pages in space | `spaceKey` |
| `delete_confluence_page` | Delete a page | `pageId` |
## Usage Examples
Once configured, you can ask your AI assistant:
- *"Create a new page called 'Sprint Review' in the TEAM space"*
- *"List all pages in my DOCS space"*
- *"Update page 12345 with this new content..."*
- *"Search for pages containing 'architecture' in the DEV space"*
## Development
```bash
# Run locally
npm start
# Run with environment variables
CONFLUENCE_URL=https://yourname.atlassian.net \
CONFLUENCE_EMAIL=you@email.com \
CONFLUENCE_API_TOKEN=token \
npm start
```
## License
MIT License - feel free to use and modify.
## Related Projects
- [mcp-atlassian](https://github.com/sooperset/mcp-atlassian) - More comprehensive Atlassian integration (Confluence + Jira)
- [Atlassian Remote MCP Server](https://github.com/atlassian-labs/mcp-remote-atlassian-server) - Official Atlassian cloud-based MCP server
