@lee_ai/confluence-mcp-server
v1.0.2
Published
MCP server for Confluence with Cookie/Session, Personal Access Token, and API Token authentication
Readme
Confluence MCP Server
Confluence MCP Server for private Confluence Server/Data Center deployments.
The recommended authentication method is a Confluence Personal Access Token.
Installation
Use with npx:
npx -y @lee_ai/confluence-mcp-serverAuthentication
For private Confluence Server/Data Center, create a Personal Access Token from your Confluence user settings, then configure:
CONFLUENCE_URL=https://wiki.yourcompany.com
CONFLUENCE_PAT=your-personal-access-token
CONFLUENCE_API_PATH=/rest/apiCONFLUENCE_ACCESS_TOKEN is also supported as an alias for CONFLUENCE_PAT.
The server sends the token as:
Authorization: Bearer <token>Codex Configuration
Add this to your Codex MCP configuration:
[mcp_servers.confluence-mcp-server]
type = "stdio"
command = "npx"
args = ["-y", "@lee_ai/confluence-mcp-server"]
[mcp_servers.confluence-mcp-server.env]
CONFLUENCE_URL = "https://wiki.yourcompany.com"
CONFLUENCE_PAT = "your-personal-access-token"
CONFLUENCE_API_PATH = "/rest/api"Tools
confluence_search: Search Confluence pages.confluence_get_page: Get a page by ID, or by space key and title.confluence_create_page: Create a page.confluence_update_page: Update a page.confluence_delete_page: Delete a page.confluence_get_comments: Get page comments.confluence_add_comment: Add a page comment.confluence_list_spaces: List spaces.confluence_get_space: Get space details.confluence_list_space_pages: List pages in a space.confluence_login: Legacy username/password login helper.
Quick Test
After configuring the MCP, ask Codex:
列出 Confluence 空间A successful response should include spaces visible to the token owner.
Troubleshooting
If you see 401 Unauthorized, check that:
- The token is a Confluence Personal Access Token, not an Atlassian Cloud API token.
- The token has not expired.
CONFLUENCE_PATis set correctly.CONFLUENCE_API_PATHis/rest/apifor private Confluence Server/Data Center.
If you see redirects or unexpected HTML responses, confirm that CONFLUENCE_URL is the base Confluence URL, for example:
CONFLUENCE_URL=https://wiki.yourcompany.comDo not include /rest/api in CONFLUENCE_URL; put it in CONFLUENCE_API_PATH.
License
MIT
