# 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