MCP Confluence Server

MCP (Model Context Protocol) server that connects AI agents to Confluence Cloud.

Why Use This

• 22 ready-to-use tools for page, blog post, label, attachment, search, and user operations
• Typed and validated inputs with Zod
• Retry with exponential backoff
• Built for MCP clients (Copilot, Claude Desktop, custom MCP runtimes)

Install

npm install -g @devpuccino/mcp-confluence

Quick Start

Set environment variables:

export CONFLUENCE_DOMAIN="your-domain.atlassian.net"
export CONFLUENCE_EMAIL="[email protected]"
export CONFLUENCE_API_TOKEN="your-api-token"

CONFLUENCE_DOMAIN supports both values below:

• your-domain.atlassian.net
• https://your-domain.atlassian.net

Add to MCP config:

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["@devpuccino/mcp-confluence"],
      "env": {
        "CONFLUENCE_DOMAIN": "your-domain.atlassian.net",
        "CONFLUENCE_EMAIL": "[email protected]",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      }
    }
  }
}

Tool Summary

• Page tools: create_page, get_page, update_page, delete_page, list_pages
• Blog post tools: create_blog_post, get_blog_post, update_blog_post, delete_blog_post, list_blog_posts
• Label tools: create_label, get_label, delete_label, list_labels
• Attachment tools: create_attachment, get_attachment, update_attachment, delete_attachment, list_attachments
• Search and user tools: search_content, get_user, get_current_user

Example Calls

Create page:

{
  "tool": "create_page",
  "arguments": {
    "spaceId": 123456,
    "title": "My New Page",
    "body": "<p>Hello World</p>",
    "format": "storage"
  }
}

Search content:

{
  "tool": "search_content",
  "arguments": {
    "query": "type=page AND text~\"project requirements\"",
    "limit": 10
  }
}

For plain text search terms, set queryType to text.

Security

• Do not hardcode credentials in source files.
• Use environment variables or a secret manager.
• Rotate Atlassian API tokens regularly.

API Notes

• Confluence REST API v2: pages, blog posts, labels, attachments
• Confluence REST API v1: search and user endpoints

References:

• https://developer.atlassian.com/cloud/confluence/rest/v2
• https://developer.atlassian.com/cloud/confluence/rest/v1

License

MIT