The Atlassian Confluence MCP Server enables AI systems to securely access, search, and retrieve content from Confluence Cloud spaces and pages via Model Context Protocol (MCP). Running locally with your credentials ensures no sensitive data is stored on remote servers.
Key capabilities include:
- List Spaces: Discover available Confluence spaces with filters for type, status, and pagination.
- Get Space Details: Retrieve comprehensive metadata about specific spaces, including descriptions and homepages.
- List Pages: Find pages within spaces with various filtering options.
- Get Page Content: Access full page content in Markdown format along with metadata.
- List Comments: Retrieve comments associated with specific pages.
- Search Content: Perform advanced searches using Confluence Query Language (CQL) or keywords.
- Automated Formatting: Convert Atlassian Document Format (ADF) to readable Markdown for consistent responses.
Connects to Atlassian's platform to access Confluence data, requiring Atlassian site credentials (site name, email, API token) for authentication and data retrieval.
Enables access to Atlassian Confluence spaces, pages, and content with tools for searching content using CQL, listing spaces, getting space details, listing pages within spaces, and retrieving full page content.
Atlassian Confluence MCP Server
A Node.js/TypeScript Model Context Protocol (MCP) server for Atlassian Confluence Cloud. Enables AI systems (e.g., LLMs like Claude or Cursor AI) to securely interact with your Confluence spaces, pages, and content in real time.
Why Use This Server?
- Minimal Input, Maximum Output: Simple identifiers provide comprehensive details without requiring extra flags.
- Complete Knowledge Base Access: Give AI assistants visibility into documentation, wikis, and knowledge base content.
- Rich Content Formatting: Automatic conversion of Atlassian Document Format to readable Markdown.
- Secure Local Authentication: Run locally with your credentials, never storing tokens on remote servers.
- Intuitive Markdown Responses: Well-structured, consistent Markdown formatting for all outputs.
What is MCP?
Model Context Protocol (MCP) is an open standard for securely connecting AI systems to external tools and data sources. This server implements MCP for Confluence Cloud, enabling AI assistants to interact with your Confluence content programmatically.
Prerequisites
- Node.js (>=18.x): Download
- Atlassian Account with access to Confluence Cloud
Setup
Step 1: Get Your Atlassian API Token
- Go to your Atlassian API token management page: https://id.atlassian.com/manage-profile/security/api-tokens
- Click Create API token.
- Give it a descriptive Label (e.g.,
mcp-confluence-access
). - Click Create.
- Copy the generated API token immediately. You won't be able to see it again.
Step 2: Configure Credentials
Option A: MCP Config File (Recommended)
Edit or create ~/.mcp/configs.json
:
<YOUR_SITE_NAME>
: Your Confluence site name (e.g.,mycompany
formycompany.atlassian.net
).<YOUR_ATLASSIAN_EMAIL>
: Your Atlassian account email.<YOUR_COPIED_API_TOKEN>
: The API token from Step 1.
Option B: Environment Variables
Step 3: Install and Run
Quick Start with npx
Global Installation
Step 4: Connect to AI Assistant
Configure your MCP-compatible client (e.g., Claude, Cursor AI):
MCP Tools
MCP tools use snake_case
names, camelCase
parameters, and return Markdown-formatted responses.
- conf_ls_spaces: Lists accessible Confluence spaces (
type
: str opt,status
: str opt,limit
: num opt,cursor
: str opt). Use: View available spaces. - conf_get_space: Gets detailed space information (
spaceKey
: str req). Use: Access space content and metadata. - conf_ls_pages: Lists pages with filtering (
spaceIds
: str[] opt,spaceKeys
: str[] opt,title
: str opt,status
: str[] opt,sort
: str opt,limit
: num opt,cursor
: str opt). Use: Find pages matching criteria. - conf_get_page: Gets comprehensive page content (
pageId
: str req). Use: View full page content as Markdown. - conf_ls_page_comments: Lists comments on a page (
pageId
: str req). Use: Read page discussions. - conf_search: Searches Confluence content (
cql
: str opt,query
: str opt,title
: str opt,spaceKey
: str opt,labels
: str[] opt,contentType
: str opt,limit
: num opt,cursor
: str opt). Use: Find specific content.
conf_ls_spaces
List Global Spaces:
conf_get_space
Get Space Details:
conf_ls_pages
List Pages by Space and Title:
List Pages from Multiple Spaces:
conf_get_page
Get Page Content:
conf_ls_page_comments
List Page Comments:
conf_search
Simple Search:
Advanced CQL Search:
CLI Commands
CLI commands use kebab-case
. Run --help
for details (e.g., mcp-atlassian-confluence ls-spaces --help
).
- ls-spaces: Lists spaces (
--type
,--status
,--limit
,--cursor
). Ex:mcp-atlassian-confluence ls-spaces --type global
. - get-space: Gets space details (
--space-key
). Ex:mcp-atlassian-confluence get-space --space-key DEV
. - ls-pages: Lists pages (
--space-keys
,--title
,--status
,--sort
,--limit
,--cursor
). Ex:mcp-atlassian-confluence ls-pages --space-keys DEV
. - get-page: Gets page content (
--page-id
). Ex:mcp-atlassian-confluence get-page --page-id 12345678
. - ls-page-comments: Lists comments (
--page-id
). Ex:mcp-atlassian-confluence ls-page-comments --page-id 12345678
. - search: Searches content (
--cql
,--query
,--space-key
,--label
,--type
,--limit
,--cursor
). Ex:mcp-atlassian-confluence search --query "security"
.
List Spaces
List Global Spaces:
Get Space
List Pages
By Multiple Space Keys:
With Title Filter:
Get Page
List Page Comments
Search
Simple Search:
CQL Search:
Response Format
All responses are Markdown-formatted, including:
- Title: Content type and name.
- Content: Full page content, search results, or list of items.
- Metadata: Creator, date, labels, and other relevant information.
- Pagination: Navigation information for paginated results.
- Links: References to related resources when applicable.
Space List Response
Page Content Response
Development
Contributing
Contributions are welcome! Please:
- Fork the repository.
- Create a feature branch (
git checkout -b feature/xyz
). - Commit changes (
git commit -m "Add xyz feature"
). - Push to the branch (
git push origin feature/xyz
). - Open a pull request.
See CONTRIBUTING.md for details.
License
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Model Context Protocol server that enables AI assistants like Claude to access and search Atlassian Confluence content, allowing integration with your organization's knowledge base.
Related MCP Servers
- -securityFlicense-qualityA comprehensive suite of Model Context Protocol servers designed to extend AI agent Claude's capabilities with integrations for knowledge management, reasoning, advanced search, news access, and workspace tools.Last updated -5TypeScript
- AsecurityFlicenseAqualityA Model Context Protocol server that connects Claude and other AI assistants to your Notion workspace, allowing AIs to interact with databases, pages, and blocks.Last updated -126410JavaScript
- -securityFlicense-qualityA Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.Last updated -275JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.Last updated -2519PythonMIT License