Skip to main content
Glama
MahithChigurupati

Confluence MCP Server

by MahithChigurupati
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Confluence MCP Server

A FastMCP-based server that provides seamless integration with Confluence's REST API, enabling programmatic access to Confluence spaces, pages, and content search functionality.

Key Features

  • Space Management: List and filter Confluence spaces

  • Page Operations: Retrieve and manage page content

  • Search Functionality: Execute CQL (Confluence Query Language) searches

  • Space Navigation: List all pages within specific spaces

  • Authentication: Secure API token-based access

System Requirements

  • Python 3.8+

  • pip (Python package manager)

  • Active Confluence instance with API access

  • Valid Confluence API token

Installation

Installing via Smithery

To install confluence-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @MahithChigurupati/confluence-mcp-server --client claude

Manual Installation

  1. Clone the Repository

    git clone https://github.com/MahithChigurupati/Confluence-MCP-Server.git cd Confluence-MCP-Server

  2. Set Up Virtual Environment (Recommended)

    python -m venv venv source venv/bin/activate # On macOS/Linux # or .\venv\Scripts\activate # On Windows

  3. Install Dependencies

    pip install -r requirements.txt

Configuration

  1. Create Environment File

    cp .env.example .env

  2. Configure Environment Variables

    CONFLUENCE_BASE_URL=https://your-instance.atlassian.net/wiki/rest/api USERNAME=your.email@company.com API_TOKEN=your-api-token-here

  3. Obtain Confluence API Token

    1. Visit Atlassian API Tokens

    2. Click "Create API Token"

    3. Enter a meaningful label (e.g., "MCP Server Access")

    4. Copy the generated token immediately (it won't be shown again)

Usage Guide

Starting the Server

python confluence.py

Available API Methods

1. List Spaces

response = await list_spaces( query="engineering", # Optional: Filter spaces by name limit=25, # Optional: Maximum number of spaces to return start=0 # Optional: Starting index for pagination )

2. Get Page Content

response = await get_page_content( page_id="123456", # Required: Confluence page ID version=2 # Optional: Specific version number )

3. Search Content

response = await search_content( query="project plan", # Required: Search query space_key="TEAM", # Optional: Limit search to specific space limit=50, # Optional: Maximum results start=0 # Optional: Starting index )

4. List Pages in Space

response = await list_pages_in_space( space_key="TEAM", # Required: Space key limit=100, # Optional: Maximum pages to return start=0 # Optional: Starting index )

Integration with MCP Clients

Claude Desktop Configuration

{ "mcpServers": { "confluence": { "command": "python path", "args": ["/path/to/Confluence-MCP-Server/confluence.py"] } } }

Location: ~/.claude/claude_desktop_config.json (macOS/Linux) or %USERPROFILE%\.claude\config.json (Windows)

Cursor Configuration

{ "mcpServers": { "confluence": { "command": "python path", "args": ["/path/to/Confluence-MCP-Server/confluence.py"] } } }

use which python to find python path

use pwd inside cloned repository to get the path. Don't forget to add confluence.py in the end.

Location: ~/.cursor/mcp.json (macOS/Linux) or %USERPROFILE%\.cursor\config.json (Windows)

Error Handling

Common error codes and their meanings:

  • 401: Invalid API token or credentials

  • 403: Insufficient permissions

  • 404: Resource not found

  • 429: Rate limit exceeded

Troubleshooting

  1. Connection Issues

    • Verify CONFLUENCE_BASE_URL format

    • Check network connectivity

    • Confirm API token validity

  2. Authentication Errors

    • Ensure USERNAME matches Atlassian account email

    • Verify API_TOKEN is correctly copied

    • Check for special characters in .env file

  3. Permission Errors

    • Confirm user has required Confluence permissions

    • Verify space and page access rights

Support

For issues and feature requests, please create an issue in the repository's issue tracker.

License

MIT License. See LICENSE file for full terms.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MahithChigurupati/Confluence-MCP-Server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server