sooperset/mcp-atlassian

Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). Supports both Cloud and Server/Data Center deployments.
https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e
Confluence Demo
https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785
Quick Start
1. Get Your API Token
Go to https://id.atlassian.com/manage-profile/security/api-tokens and create a token.
> For Server/Data Center, use a Personal Access Token instead. See Authentication.
2. Configure Your IDE
Add to your Claude Desktop or Cursor MCP configuration:
> **Server/Data Center users**: Use JIRA_PERSONAL_TOKEN instead of JIRA_USERNAME + JIRA_API_TOKEN. See Authentication for details.
Autohand Code
Use the same uvx server with your Atlassian credentials:
Add --scope project after add to keep the configuration in the current
project. See Autohand Code for current
installation and CLI details.
3. Start Using
Ask your AI assistant to:
- **"Find issues assigned to me in PROJ project"**
- **"Search Confluence for onboarding docs"**
- **"Create a bug ticket for the login issue"**
- **"Update the status of PROJ-123 to Done"**
Documentation
Full documentation is available at **mcp-atlassian.soomiles.com**.
Documentation is also available in llms.txt format, which LLMs can consume easily:
- llms.txt — documentation sitemap
- llms-full.txt — complete documentation
| Topic | Description |
|-------|-------------|
| Installation | uvx, Docker, pip, from source |
| Authentication | API tokens, PAT, OAuth 2.0 |
| Configuration | IDE setup, environment variables |
| HTTP Transport | SSE, streamable-http, multi-user |
| Tools Reference | All Jira & Confluence tools |
| Troubleshooting | Common issues & debugging |
Compatibility
| Product | Deployment | Support |
|---------|------------|---------|
| Confluence | Cloud | Fully supported |
| Confluence | Server/Data Center | Supported (v6.0+) |
| Jira | Cloud | Fully supported |
| Jira | Server/Data Center | Supported (v8.14+) |
Key Tools
| Jira | Confluence |
|------|------------|
| jira_search - Search with JQL | confluence_search - Search with CQL |
| jira_get_issue - Get issue details | confluence_get_page - Get page content |
| jira_create_issue - Create issues | confluence_create_page - Create pages |