confluence-mcp
Allows reading, writing, searching, and managing attachments on Confluence pages via the Confluence REST API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@confluence-mcp search for pages about API in the DEV space"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Confluence MCP Server
MCP server for Confluence integration — read, write, search, and manage attachments via the Confluence REST API.
Installation
npm install -g @mcd/confluence-mcp-serverOr use with npx:
npx @mcd/confluence-mcp-serverRelated MCP server: confluence-mcp
Configuration
Add to your MCP settings (e.g. ~/.kiro/settings/mcp.json):
{
"mcpServers": {
"confluence-mcp": {
"command": "npx",
"args": ["@mcd/confluence-mcp-server@latest"],
"env": {
"CONFLUENCE_URL": "https://your-confluence.atlassian.net",
"CONFLUENCE_USERNAME": "your-email@example.com",
"CONFLUENCE_TOKEN": "your-api-token",
"CONFLUENCE_CLOUD": "true"
}
}
}
}For local development, point directly to the compiled output:
{
"mcpServers": {
"confluence-mcp": {
"command": "node",
"args": ["/absolute/path/to/dist/index.js"],
"env": {
"CONFLUENCE_URL": "...",
"CONFLUENCE_USERNAME": "...",
"CONFLUENCE_TOKEN": "...",
"CONFLUENCE_CLOUD": "false"
}
}
}
}Environment Variables
Variable | Description |
| Your Confluence instance URL |
| Your username or email |
| Your API token or password |
|
|
Available Tools
Pages
search— Search Confluence content (CQL)get_page— Get page content by IDget_page_children— Get child pages of a parent pagecreate_page— Create a new pageupdate_page— Update page content (inline HTML or file path)
Attachments
get_attachments— List attachments on a pagedownload_attachment— Download an attachment to local diskupload_attachment— Upload a local file as a page attachment, with optional embedding in page body
Comments
get_comments— Get page commentsadd_comment— Add a comment to a page
Tool Examples
Search:
{ "query": "space = DEV AND title ~ \"API\"", "limit": 10 }Update page with inline content:
{ "page_id": "123456", "content": "<h1>Title</h1><p>Updated content</p>" }Update page from file (recommended for large content):
{ "page_id": "123456", "content_file": "/absolute/path/to/content.html" }Upload attachment:
{ "page_id": "123456", "file_path": "/absolute/path/to/file.png" }Upload and embed in page body:
{
"page_id": "123456",
"file_path": "/absolute/path/to/image.png",
"embed_in_body": true,
"comment": "Optional comment"
}Images are embedded as <ac:image>, other files as a view-file macro link.
Development
npm install
npm run buildAvailable Tools
10 toolsadd_commentB
Add a comment to a Confluence page
Inputs: content (required), page_id (required).
create_pageC
Create a new Confluence page
Inputs: title (required), content (required), space_key (required), parent_id.
download_attachmentB
Download a Confluence attachment
Inputs: page_id (required), output_path (required), attachment_id (required).
get_attachmentsB
Get attachments from a Confluence page
Inputs: page_id (required).
get_commentsB
Get comments from a Confluence page
Inputs: page_id (required), limit, start.
get_pageC
Get Confluence page content
Inputs: page_id (required), include_body.
get_page_childrenB
Get child pages of a Confluence page
Inputs: parent_id (required), limit, start.
searchB
Search Confluence content
Inputs: query (required), limit.
update_pageA
Update a Confluence page with new content.
IMPORTANT: For large HTML files, use 'content_file' parameter to provide the file path. The tool automatically handles:
Escaping unescaped & characters to &
Cleaning HTML structure (removes DOCTYPE, html, head, body tags)
Inputs: page_id (required), title, content, minor_edit, +1 more.
upload_attachmentA
Upload a file as an attachment to a Confluence page. The file must be specified by its absolute path on the local filesystem. Optionally embed the attachment in the page body.
Inputs: page_id (required), file_path (required), comment, embed_in_body.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool targets a distinct resource and action: search, page retrieval, children, attachments (list vs download), comments (list vs add), page create/update, and attachment upload. No two tools appear to do the same thing.
Most names follow a clear verb_noun pattern (get_page, create_page, update_page, upload_attachment). The mix of verbs like search, get, download, add, create, update, upload is reasonable and readable, though not perfectly uniform.
With 10 tools, the set is well-scoped for a Confluence MCP server covering search, page content, comments, and attachments. Each tool has a clear role without feeling excessive.
Core content operations are covered (search, read, create, update, comment, attachments), but there are no delete operations for pages, comments, or attachments. This is a notable gap for full lifecycle management, though typical workflows are still possible.
Maintenance
Related MCP Connectors
Unofficial Confluence MCP — wraps the Confluence Cloud REST API v2 (OAuth)
Connect to your MediaWiki using simple credentials and manage content without OAuth. Search, read,…
Read tickets, users, orgs, macros and satisfaction ratings; create, update and comment on tickets.
Search and manage your team's knowledge from MCP clients.
Related MCP Servers
- FlicenseAqualityFmaintenanceEnables interaction with Jira and Confluence APIs to search, create, and manage issues, pages, comments, and attachments across both Atlassian platforms.7-
- FlicenseNot gradedqualityCmaintenanceProvides read access to Confluence Server/Data Center pages, sections, tables, and search via the Confluence REST API v1.-
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Atlassian Confluence through MCP, allowing retrieval of pages by ID and searching with CQL queries.-
- AlicenseAqualityAmaintenanceEnables interaction with Atlassian Jira and Confluence via their REST API, providing tools for searching, creating, updating, commenting, and retrieving issues, pages, projects, and spaces.14MIT