{"id":28768189,"url":"https://github.com/aaronsb/confluence-cloud-mcp","last_synced_at":"2025-09-06T00:58:59.423Z","repository":{"id":274097054,"uuid":"914018091","full_name":"aaronsb/confluence-cloud-mcp","owner":"aaronsb","description":"A Model Context Protocol (MCP) server that enables AI assistants to manage Confluence Cloud spaces, pages, and content through a standardized interface.","archived":false,"fork":false,"pushed_at":"2025-07-31T22:02:39.000Z","size":5899,"stargazers_count":15,"open_issues_count":5,"forks_count":8,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-01T00:42:49.747Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aaronsb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-08T19:40:17.000Z","updated_at":"2025-07-31T22:02:43.000Z","dependencies_parsed_at":"2025-08-01T00:02:37.883Z","dependency_job_id":"fa2d6296-fff3-4f39-80b4-c134dfa899d4","html_url":"https://github.com/aaronsb/confluence-cloud-mcp","commit_stats":null,"previous_names":["aaronsb/confluence-cloud-mcp"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/aaronsb/confluence-cloud-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fconfluence-cloud-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fconfluence-cloud-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fconfluence-cloud-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fconfluence-cloud-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aaronsb","download_url":"https://codeload.github.com/aaronsb/confluence-cloud-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronsb%2Fconfluence-cloud-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273842818,"owners_count":25177921,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-17T13:02:54.616Z","updated_at":"2025-09-06T00:58:59.413Z","avatar_url":"https://github.com/aaronsb.png","language":"TypeScript","readme":"# Confluence Cloud MCP Server\n\nA Model Context Protocol (MCP) server that provides tools for interacting with Confluence Cloud. This server enables AI assistants to manage Confluence spaces, pages, and content through a standardized interface.\n\n[![CI/CD Pipeline](https://github.com/aaronsb/confluence-cloud-mcp/actions/workflows/ci-cd.yml/badge.svg)](https://github.com/aaronsb/confluence-cloud-mcp/actions/workflows/ci-cd.yml)\n\n## Features\n\n- Space Management\n  - List spaces\n  - Get space details\n- Page Operations\n  - Create, read, update pages\n  - List pages in a space\n  - Convert page content from Confluence storage format to Markdown\n- Search \u0026 Labels\n  - Search content using CQL\n  - Manage page labels\n\n## Setup\n\n### Option 1: Using Docker (Recommended)\n\nThe easiest way to use this server is with the pre-built Docker image:\n\n```bash\ndocker run --rm -i \\\n  -e CONFLUENCE_API_TOKEN=your-api-token \\\n  -e CONFLUENCE_EMAIL=your-email@domain.com \\\n  -e CONFLUENCE_DOMAIN=your-domain.atlassian.net \\\n  ghcr.io/aaronsb/confluence-cloud-mcp:latest\n```\n\n### Option 2: Building Locally\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/aaronsb/confluence-cloud-mcp.git\ncd confluence-cloud-mcp\n```\n\n2. Build and run using the local build script:\n```bash\n# Build the Docker image\n./scripts/build-local.sh\n\n# Run the server\nCONFLUENCE_API_TOKEN=your-token CONFLUENCE_EMAIL=your-email ./scripts/run-local.sh\n```\n\n### Option 3: Using npx (Direct from GitHub)\n\nRun directly from GitHub without installation:\n\n```bash\n# With inline environment variables\nCONFLUENCE_DOMAIN=your-domain.atlassian.net \\\nCONFLUENCE_EMAIL=your-email@domain.com \\\nCONFLUENCE_API_TOKEN=your-api-token \\\nnpx github:aaronsb/confluence-cloud-mcp\n\n# Or with an environment file\nnpx github:aaronsb/confluence-cloud-mcp --env /path/to/.env\n```\n\nCreate a `.env` file with your Confluence credentials:\n```\nCONFLUENCE_DOMAIN=your-domain.atlassian.net\nCONFLUENCE_EMAIL=your-email@domain.com\nCONFLUENCE_API_TOKEN=your-api-token\n```\n\n### Option 4: From Source\n\n1. Install dependencies:\n```bash\nnpm install\n```\n\n2. Configure environment variables:\nCreate a `.env` file with your Confluence credentials:\n```\nCONFLUENCE_DOMAIN=your-domain.atlassian.net\nCONFLUENCE_EMAIL=your-email@domain.com\nCONFLUENCE_API_TOKEN=your-api-token\n```\n\n3. Build the project:\n```bash\nnpm run build\n```\n\n4. Run the server:\n```bash\nnode build/index.js\n```\n\n## Usage\n\nThe server can be integrated with MCP-compatible AI assistants by adding it to their MCP configuration:\n\n**Using Claude Code CLI:**\n```bash\nclaude mcp add confluence-cloud npx -- github:aaronsb/confluence-cloud-mcp --env /path/to/.env\n```\n\n**Using npx in MCP configuration:**\n```json\n{\n  \"mcpServers\": {\n    \"confluence\": {\n      \"command\": \"npx\",\n      \"args\": [\"github:aaronsb/confluence-cloud-mcp\", \"--env\", \"/path/to/.env\"],\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n**Using Docker:**\n```json\n{\n  \"mcpServers\": {\n    \"confluence\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"--rm\", \"-i\", \"ghcr.io/aaronsb/confluence-cloud-mcp:latest\"],\n      \"env\": {\n        \"CONFLUENCE_DOMAIN\": \"your-domain.atlassian.net\",\n        \"CONFLUENCE_EMAIL\": \"your-email@domain.com\",\n        \"CONFLUENCE_API_TOKEN\": \"your-api-token\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\n\u003e **Note for AI Assistants**: If you're an AI assistant like Cline trying to install this MCP server, please refer to the [llms-install.md](llms-install.md) file for detailed installation instructions.\n\n## Available Tools\n\n### Space Tools\n- `list_confluence_spaces`: List all spaces in Confluence\n- `get_confluence_space`: Get details about a specific space\n\n### Page Tools\n- `list_confluence_pages`: List pages in a space\n- `get_confluence_page`: Get a specific page with its content (now includes Markdown conversion)\n- `create_confluence_page`: Create a new page in a space\n- `update_confluence_page`: Update an existing page\n\nThe `get_confluence_page` tool now automatically converts Confluence storage format content to Markdown, making it easier to work with page content. The conversion handles:\n- Headers (h1-h6)\n- Lists (ordered and unordered)\n- Links\n- Emphasis (bold/italic)\n- Code blocks\n- Tables\n- Paragraphs and line breaks\n\n### Search \u0026 Label Tools\n- `search_confluence_pages`: Search Confluence content using CQL\n- `get_confluence_labels`: Get labels for a page\n- `add_confluence_label`: Add a label to a page\n- `remove_confluence_label`: Remove a label from a page\n\n\u003e **Note**: All tool names follow the [verb]_confluence_[noun] naming convention for consistency and clarity.\n\n## Development\n\nThis project is written in TypeScript and follows the MCP SDK conventions for implementing server capabilities. The codebase is organized into:\n\n- `src/client/` - Confluence API client implementation\n- `src/handlers/` - MCP tool request handlers\n- `src/schemas/` - JSON schemas for tool inputs\n- `src/types/` - TypeScript type definitions\n- `src/utils/` - Utility functions including content format conversion\n\n### CI/CD Pipeline\n\nThis project uses GitHub Actions for continuous integration and deployment:\n\n- Automated testing and linting on pull requests\n- Automatic Docker image builds on main branch commits\n- Multi-architecture image builds (amd64, arm64)\n- Container publishing to GitHub Container Registry\n\n### Local Development\n\nFor local development, use the provided scripts:\n\n- `./scripts/build-local.sh`: Builds the project and creates a local Docker image\n- `./scripts/run-local.sh`: Runs the local Docker image with your credentials\n\n## License\n\nMIT\n","funding_links":[],"categories":["Project Management MCP Servers","Task and Project Management","🌐 Web Development"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronsb%2Fconfluence-cloud-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faaronsb%2Fconfluence-cloud-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronsb%2Fconfluence-cloud-mcp/lists"}