{"id":26641096,"url":"https://github.com/aashari/mcp-server-atlassian-confluence","last_synced_at":"2025-04-10T20:44:35.273Z","repository":{"id":283917717,"uuid":"953301407","full_name":"aashari/mcp-server-atlassian-confluence","owner":"aashari","description":"Node.js/TypeScript MCP server for Atlassian Confluence. Provides tools enabling AI systems (LLMs) to list/get spaces \u0026 pages (content formatted as Markdown) and search via CQL. Connects AI seamlessly to Confluence knowledge bases using the standard MCP interface.","archived":false,"fork":false,"pushed_at":"2025-04-09T04:55:53.000Z","size":1583,"stargazers_count":1,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T05:01:54.439Z","etag":null,"topics":["ai","ai-connector","ai-integration","anthropic","atlassian","claude","cli","confluence","external-tools","knowledge-base","llm","mcp","mcp-server","model-context-protocol","server","typescript","wiki"],"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/aashari.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2025-03-23T03:06:24.000Z","updated_at":"2025-04-09T04:55:56.000Z","dependencies_parsed_at":"2025-03-23T03:15:25.386Z","dependency_job_id":"a3423c5b-540f-4bd5-801b-41052b1d42b4","html_url":"https://github.com/aashari/mcp-server-atlassian-confluence","commit_stats":null,"previous_names":["aashari/mcp-server-atlassian-confluence"],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aashari%2Fmcp-server-atlassian-confluence","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aashari%2Fmcp-server-atlassian-confluence/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aashari%2Fmcp-server-atlassian-confluence/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aashari%2Fmcp-server-atlassian-confluence/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aashari","download_url":"https://codeload.github.com/aashari/mcp-server-atlassian-confluence/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248294487,"owners_count":21079899,"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","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":["ai","ai-connector","ai-integration","anthropic","atlassian","claude","cli","confluence","external-tools","knowledge-base","llm","mcp","mcp-server","model-context-protocol","server","typescript","wiki"],"created_at":"2025-03-24T18:19:44.170Z","updated_at":"2025-04-10T20:44:35.266Z","avatar_url":"https://github.com/aashari.png","language":"TypeScript","funding_links":[],"categories":["Productivity","🤖 AI/ML","پیاده‌سازی‌های سرور","MCP Servers","Knowledge \u0026 Memory","カテゴリ","Document Processing","Knowledge Management"],"sub_categories":["Atlassian","💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eابزارهای توسعه‌دهنده","🛠️ Development Tools","How to Submit","📝 \u003ca name=\"content--media\"\u003e\u003c/a\u003eコンテンツ・メディア"],"readme":"# Atlassian Confluence MCP Server\n\nThis project provides a Model Context Protocol (MCP) server that acts as a bridge between AI assistants (like Anthropic's Claude, Cursor AI, or other MCP-compatible clients) and your Atlassian Confluence instance. It allows AI to securely access and interact with your Confluence spaces and pages in real time.\n\n---\n\n# Overview\n\n## What is MCP?\n\nModel Context Protocol (MCP) is an open standard that allows AI systems to securely and contextually connect with external tools and data sources.\n\nThis server implements MCP specifically for Confluence Cloud, bridging your Confluence data with AI assistants.\n\n## Why Use This Server?\n\n- **Minimal Input, Maximum Output Philosophy**: Simple identifiers like `spaceKey` and `pageId` are all you need. Each tool returns comprehensive details without requiring extra flags.\n\n- **Complete Knowledge Base Access**: Provide your AI assistant with full visibility into your documentation, wikis, and knowledge base content in real time.\n\n- **Rich Content Formatting**: All page content is automatically converted from Atlassian Document Format to Markdown with proper headings, tables, lists, and other formatting elements.\n\n- **Secure Local Authentication**: Credentials are never stored in the server. The server runs locally, so your tokens never leave your machine and you can request only the permissions you need.\n\n- **Intuitive Markdown Responses**: All responses use well-structured Markdown for readability with consistent formatting and navigational links.\n\n---\n\n# Getting Started\n\n## Prerequisites\n\n- **Node.js** (\u003e=18.x): [Download](https://nodejs.org/)\n- **Atlassian Account** with access to Confluence Cloud\n\n---\n\n## Step 1: Get Your Atlassian API Token\n\n1. Go to your Atlassian API token management page:\n   [https://id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)\n2. Click **Create API token**.\n3. Give it a descriptive **Label** (e.g., `mcp-confluence-access`).\n4. Click **Create**.\n5. **Copy the generated API token** immediately. You won't be able to see it again.\n\n---\n\n## Step 2: Configure Credentials\n\n### Method A: MCP Config File (Recommended)\n\nCreate or edit `~/.mcp/configs.json`:\n\n```json\n{\n\t\"@aashari/mcp-server-atlassian-confluence\": {\n\t\t\"environments\": {\n\t\t\t\"ATLASSIAN_SITE_NAME\": \"\u003cYOUR_SITE_NAME\u003e\",\n\t\t\t\"ATLASSIAN_USER_EMAIL\": \"\u003cYOUR_ATLASSIAN_EMAIL\u003e\",\n\t\t\t\"ATLASSIAN_API_TOKEN\": \"\u003cYOUR_COPIED_API_TOKEN\u003e\"\n\t\t}\n\t}\n}\n```\n\n- `\u003cYOUR_SITE_NAME\u003e`: Your Confluence site name (e.g., `mycompany` for `mycompany.atlassian.net`).\n- `\u003cYOUR_ATLASSIAN_EMAIL\u003e`: Your Atlassian account email.\n- `\u003cYOUR_COPIED_API_TOKEN\u003e`: The API token from Step 1.\n\n### Method B: Environment Variables\n\nPass credentials directly when running the server:\n\n```bash\nATLASSIAN_SITE_NAME=\"\u003cYOUR_SITE_NAME\u003e\" \\\nATLASSIAN_USER_EMAIL=\"\u003cYOUR_EMAIL\u003e\" \\\nATLASSIAN_API_TOKEN=\"\u003cYOUR_API_TOKEN\u003e\" \\\nnpx -y @aashari/mcp-server-atlassian-confluence\n```\n\n---\n\n## Step 3: Connect Your AI Assistant\n\nConfigure your MCP-compatible client to launch this server.\n\n**Claude / Cursor Configuration:**\n\n```json\n{\n\t\"mcpServers\": {\n\t\t\"aashari/mcp-server-atlassian-confluence\": {\n\t\t\t\"command\": \"npx\",\n\t\t\t\"args\": [\"-y\", \"@aashari/mcp-server-atlassian-confluence\"]\n\t\t}\n\t}\n}\n```\n\nThis configuration launches the server automatically at runtime.\n\n---\n\n# Tools\n\nThis section covers the MCP tools available when using this server with an AI assistant. Note that MCP tools use `snake_case` for tool names and `camelCase` for parameters.\n\n## `list_spaces`\n\nList available Confluence spaces with optional filtering.\n\n```json\n{}\n```\n\n_or:_\n\n```json\n{ \"type\": \"global\", \"status\": \"current\" }\n```\n\n\u003e \"Show me all Confluence spaces.\"\n\n---\n\n## `get_space`\n\nGet full details for a specific space, including homepage information.\n\n```json\n{ \"spaceKey\": \"DEV\" }\n```\n\n\u003e \"Tell me about the DEV space in Confluence.\"\n\n---\n\n## `list_pages`\n\nList pages within one or more spaces with optional filtering.\n\n```json\n{ \"spaceId\": [\"123456\"] }\n```\n\n_or:_\n\n```json\n{ \"status\": [\"current\"], \"query\": \"Project Plan\" }\n```\n\n\u003e \"Show me current pages in space 123456.\"\n\n---\n\n## `get_page`\n\nGet full content and metadata for a specific page.\n\n```json\n{ \"pageId\": \"12345678\" }\n```\n\n\u003e \"Get the content of Confluence page 12345678.\"\n\n---\n\n## `search`\n\nSearch Confluence content using CQL (Confluence Query Language).\n\n```json\n{ \"cql\": \"text ~ 'project plan'\" }\n```\n\n_or:_\n\n```json\n{ \"cql\": \"space = DEV AND label = api AND created \u003e= '2023-01-01'\" }\n```\n\n\u003e \"Search Confluence for pages about project plans.\"\n\n---\n\n# Command-Line Interface (CLI)\n\nThe CLI uses kebab-case for commands (e.g., `list-spaces`) and options (e.g., `--space-key`).\n\n## Quick Use with `npx`\n\n```bash\nnpx -y @aashari/mcp-server-atlassian-confluence list-spaces\nnpx -y @aashari/mcp-server-atlassian-confluence get-page --page 12345678\n```\n\n## Install Globally\n\n```bash\nnpm install -g @aashari/mcp-server-atlassian-confluence\n```\n\nThen run directly:\n\n```bash\nmcp-atlassian-confluence list-spaces\n```\n\n## Discover More CLI Options\n\nUse `--help` to see flags and usage for all available commands:\n\n```bash\nmcp-atlassian-confluence --help\n```\n\nOr get detailed help for a specific command:\n\n```bash\nmcp-atlassian-confluence get-space --help\nmcp-atlassian-confluence search --help\nmcp-atlassian-confluence list-pages --help\n```\n\n---\n\n# License\n\n[ISC License](https://opensource.org/licenses/ISC)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faashari%2Fmcp-server-atlassian-confluence","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faashari%2Fmcp-server-atlassian-confluence","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faashari%2Fmcp-server-atlassian-confluence/lists"}