confluence-mcp
Provides tools for interacting with Confluence's REST API, enabling management of pages, spaces, attachments, comments, and full-text search.
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 find pages about Q4 roadmap"
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
MCP server for Confluence REST API. Bearer token (PAT) auth.
API documentation:
Setup
Environment variables
Variable | Required | Description |
| yes | REST API base URL, e.g. |
| yes | Personal Access Token |
| no |
|
Creating a Personal Access Token (PAT)
curl -s -u 'your-username:your-password' \
-X POST -H "Content-Type: application/json" \
-d '{"name":"my-mcp-token"}' \
"https://wiki.example.com/rest/pat/latest/tokens"
# Save rawToken from the response — it won't be shown againClaude Desktop / Claude Code — uvx (no install)
{
"mcpServers": {
"confluence": {
"command": "uvx",
"args": ["--from", "git+https://github.com/mainpart/confluence-mcp", "confluence-mcp"],
"env": {
"CONFLUENCE_URL": "https://wiki.example.com/rest/api",
"CONFLUENCE_TOKEN": "your-pat-token"
}
}
}
}Related MCP server: confluence-mcp-server
Tools (6)
Tool | Description |
| Page with body (storage format), ancestors, child pages, attachments |
| Download attachment by its |
| List spaces (key + name), filter by type, status, label |
| Page comments (footer + inline with markerRef and originalSelection) |
| Full-text search with filters: title, space, type, creator, contributor, label, ancestor, parent, dates |
| User profile by username or userKey |
Errors
Every tool returns errors as JSON instead of raising, so a caller can branch on
a field: {"error": "api_error" \| "bad_request" \| "unexpected", "message": "...", "status": 403} (status only when the API answered with an HTTP code).
License
MIT
Available Tools
6 toolsdownload_attachmentDownload Confluence AttachmentC
Download attachment content.
Inputs: attachment_id (required), save_path. Returns: result
get_commentsGet Confluence CommentsARead-only
Get comments on a page or comment thread by content ID.
Returns footer and inline comments. Inline comments have markerRef — UUID of ac:inline-comment-marker in page body.storage. Pass a comment ID to get its reply thread.
Inputs: id (required), depth, limit, start, +1 more. Returns: result
get_content_by_idGet Confluence PageARead-only
Get content by ID. Returns title, body (storage format HTML), space, version, ancestors, child pages, attachments.
Inputs: id (required), status, save_path. Returns: result
get_spacesList Confluence SpacesBRead-only
Get spaces. Returns key and name. Filter by space_key, status, label, favourite.
Inputs: label, limit, start, status, +3 more. Returns: result
get_userGet Confluence UserARead-only
Get user profile by username or userKey. Returns displayName, username, userKey.
Inputs: key, username. Returns: result
searchSearch ConfluenceARead-only
Search Confluence. All filters are combined with AND. For paginated results use start/limit params; check hasMore in the response.
Inputs: type, label, limit, query, +10 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct resource and action: content, attachment, spaces, comments, search, and user. There is no overlap in purpose, making selection unambiguous.
All tools follow a consistent verb_noun snake_case pattern, with verbs like get, download, and search. The naming convention is uniform and predictable.
Six tools is a well-scoped number for a Confluence integration, covering core read operations without being excessive. Each tool earns its place.
The surface covers read-only operations for content, comments, spaces, users, attachments, and search. However, there are no create, update, or delete operations, which is a notable gap for a full Confluence API.
Maintenance
Related MCP Connectors
Unofficial Confluence MCP — wraps the Confluence Cloud REST API v2 (OAuth)
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Find, document and execute authenticated API calls across 1000+ apps via one MCP server
MCP Server for JFrog, providing tools for development and artifact management.
Related MCP Servers
- FlicenseCqualityDmaintenanceAn MCP server that enables searching and retrieving content from Confluence documentation systems, providing capabilities for both document searches and full page content retrieval.21-
- AlicenseAqualityDmaintenanceMCP server for Confluence Cloud/Server/Data Center, enabling page search, CQL queries, page CRUD, attachment upload, and user identity lookup.23412 npm5MIT
- AlicenseBqualityDmaintenanceMCP server for administering Atlassian Confluence Cloud wiki pages, supporting CRUD operations, page navigation, comments, attachments, and more.621GPL 3.0
- AlicenseNot gradedqualityDmaintenanceMCP server for searching and retrieving pages from Atlassian Confluence.30 npm1MIT