atlassian

This MCP server provides integration with Atlassian Cloud services (Confluence, Jira, and Service Management) using OAuth 2.0. It includes modular clients for Jira, Confluence, and Service Desk that can be selectively loaded via environment configuration. Once authenticated, AI agents can search Jira issues, read Confluence pages for context, manage service desk requests, and log work activities. Start by configuring which modules you want loaded to optimize performance and security. The server handles automatic token management and token refresh, so long-running sessions are feasible.

To use the server, run the configured command to start the MCP server and follow the prompts for initial authentication. After startup, you can leverage the available modules through the server's APIs or tooling that integrates with MCP. Ensure your environment variables are set (site URL, client ID, client secret) and that the necessary scopes are granted in your Atlassian OAuth app. If you need to revoke or refresh tokens, re-authenticate using the provided authentication flow to obtain fresh tokens with updated permissions.

Prerequisites:\n- Python 3.8 or higher\n- pip3 package manager\n- Access to an Atlassian Cloud site\n- OAuth app configured (see OAuth App Setup in the README)\n\nInstall from PyPI (Recommended)\nbash\npip3 install atlassian-mcp-server\n\n\nInstall from GitHub Repository (direct install)\nbash\n# Install directly from GitHub repository\npip3 install git+https://github.com/rorymcmahon/atlassian-mcp-server.git\n\n\nInstall from Source (development mode)\nbash\n# Clone the repository\ngit clone https://github.com/rorymcmahon/atlassian-mcp-server.git\ncd atlassian-mcp-server\n\n# Install in development mode\npip3 install -e .\n\n\nVerify Installation\nbash\n# Check that the command is available\natlassian-mcp-server --help\n\n# Or check the Python module\npython -m atlassian_mcp_server --help\n

Environment variables and configuration options:\n- Required: ATLASSIAN_SITE_URL, ATLASSIAN_CLIENT_ID, ATLASSIAN_CLIENT_SECRET. These must be set to your Atlassian site URL and OAuth credentials.\n- Optional: ATLASSIAN_MODULES to control which modules load (e.g., jira, confluence, service_desk). Disabling unused modules can reduce memory usage and speed startup.\n- Scopes: Ensure the OAuth app has all required scopes (read/jira-work, read/jira-user, write/jira-work, read:page:confluence, read:space:confluence, write:page:confluence, read:servicedesk-request, write:servicedesk-request, manage:servicedesk-customer, read:knowledgebase:jira-service-management, read:me, offline_access). After adding scopes, re-authenticate using the authenticate_atlassian tool to obtain tokens with the new permissions.\n- Troubleshooting: If scopes cause errors like scope does not match or unauthorized, re-authenticate and verify that the scopes are correctly configured in the OAuth app.\n- OAuth App Setup steps in the README provide detailed instructions for creating the app, selecting scopes, and installing to your Atlassian site.