Confluence MCP Server
Search, read, create, and update Confluence pages and spaces from your AI assistant
The Confluence MCP Server — part of the @sooperset/mcp-atlassian package — connects Claude and other MCP-compatible agents to Confluence Cloud via the Atlassian REST API. Search your knowledge base, read full page content, create new pages, and update existing documentation — all from within your AI chat session. The same package also supports Jira; see the Jira MCP Server page for those tools.
Installation & Configuration
Add this block to your claude_desktop_config.json (or your agent framework's MCP config file):
{
"mcpServers": {
"confluence": {
"command": "npx",
"args": ["-y", "@sooperset/mcp-atlassian"],
"env": {
"CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
"ATLASSIAN_EMAIL": "you@example.com",
"ATLASSIAN_TOKEN": "your_api_token_here"
}
}
}
}
Note: This package includes both Jira and Confluence tools. If you want both simultaneously, you can configure a single entry with both JIRA_URL and CONFLUENCE_URL set, or run two separate named entries.
Generating an Atlassian API token:
- Go to id.atlassian.com → API tokens
- Click "Create API token" and give it a label
- Copy the token — it's only shown once
- Use your Atlassian account email as
ATLASSIAN_EMAIL
Config file location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/claude/claude_desktop_config.json
Available Tools (5)
confluence_searchconfluence_get_pageconfluence_create_pageconfluence_update_pageconfluence_get_space
Use Cases
- Knowledge base Q&A — ask Claude to find and summarise the relevant runbook before an incident
- Documentation drafting — describe a new feature and have Claude write a Confluence page for it
- Onboarding — let Claude search and pull together all pages tagged for a specific team or project
- Page updates — ask Claude to update an existing page with new information without opening the editor
Gotchas
- CONFLUENCE_URL must include /wiki: For Confluence Cloud the base URL is
https://your-domain.atlassian.net/wiki. Omitting/wikicauses all API calls to return 404. - Page storage format: Confluence stores page bodies in "storage format" (an XML-like dialect). When creating or updating pages, Claude will generate this format — verify the output looks correct before saving to important pages.
- Space key vs space name: Tools like
confluence_get_spaceexpect the space key (e.g.ENG), not the display name ("Engineering"). Find keys in your Confluence URL or space settings. - API token, not password: Like all Atlassian REST API calls, this requires an API token from id.atlassian.com — your login password will return a 401.
Security Note
The Atlassian API token is tied to your personal account and grants read and write access to every Confluence space you have permission to view or edit. The server can create, overwrite, and publish pages. Store the token only in your MCP config (outside version control) and revoke it from id.atlassian.com if exposed.
Source & Documentation
GitHub Repository: https://github.com/sooperset/mcp-atlassian
Protocol: Model Context Protocol (MCP) — modelcontextprotocol.io
20 ready-to-paste server configs + installer + doctor script