MCP Atlassian

1# MCP Atlassian
2 
3![PyPI Version](https://img.shields.io/pypi/v/mcp-atlassian)
4![PyPI - Downloads](https://img.shields.io/pypi/dm/mcp-atlassian)
5![PePy - Total Downloads](https://static.pepy.tech/personalized-badge/mcp-atlassian?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Total%20Downloads)
6[![Run Tests](https://github.com/sooperset/mcp-atlassian/actions/workflows/tests.yml/badge.svg)](https://github.com/sooperset/mcp-atlassian/actions/workflows/tests.yml)
7![License](https://img.shields.io/github/license/sooperset/mcp-atlassian)
8[![Docs](https://img.shields.io/badge/docs-mintlify-blue)](https://personal-1d37018d.mintlify.app)
9 
10Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). Supports both Cloud and Server/Data Center deployments.
11 
12https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e
13 
14<details>
15<summary>Confluence Demo</summary>
16 
17https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785
18 
19</details>
20 
21## Quick Start
22 
23### 1. Get Your API Token
24 
25Go to https://id.atlassian.com/manage-profile/security/api-tokens and create a token.
26 
27> For Server/Data Center, use a Personal Access Token instead. See [Authentication](https://personal-1d37018d.mintlify.app/docs/authentication).
28 
29### 2. Configure Your IDE
30 
31Add to your Claude Desktop or Cursor MCP configuration:
32 
33```json
34{
35  "mcpServers": {
36    "mcp-atlassian": {
37      "command": "uvx",
38      "args": ["mcp-atlassian"],
39      "env": {
40        "JIRA_URL": "https://your-company.atlassian.net",
41        "JIRA_USERNAME": "your.email@company.com",
42        "JIRA_API_TOKEN": "your_api_token",
43        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
44        "CONFLUENCE_USERNAME": "your.email@company.com",
45        "CONFLUENCE_API_TOKEN": "your_api_token"
46      }
47    }
48  }
49}
50```
51 
52> **Server/Data Center users**: Use `JIRA_PERSONAL_TOKEN` instead of `JIRA_USERNAME` + `JIRA_API_TOKEN`. See [Authentication](https://personal-1d37018d.mintlify.app/docs/authentication) for details.
53 
54### 3. Start Using
55 
56Ask your AI assistant to:
57- **"Find issues assigned to me in PROJ project"**
58- **"Search Confluence for onboarding docs"**
59- **"Create a bug ticket for the login issue"**
60- **"Update the status of PROJ-123 to Done"**
61 
62## Documentation
63 
64Full documentation is available at **[personal-1d37018d.mintlify.app](https://personal-1d37018d.mintlify.app)**.
65 
66Documentation is also available in [llms.txt format](https://llmstxt.org/), which LLMs can consume easily:
67- [`llms.txt`](https://personal-1d37018d.mintlify.app/llms.txt) — documentation sitemap
68- [`llms-full.txt`](https://personal-1d37018d.mintlify.app/llms-full.txt) — complete documentation
69 
70| Topic | Description |
71|-------|-------------|
72| [Installation](https://personal-1d37018d.mintlify.app/docs/installation) | uvx, Docker, pip, from source |
73| [Authentication](https://personal-1d37018d.mintlify.app/docs/authentication) | API tokens, PAT, OAuth 2.0 |
74| [Configuration](https://personal-1d37018d.mintlify.app/docs/configuration) | IDE setup, environment variables |
75| [HTTP Transport](https://personal-1d37018d.mintlify.app/docs/http-transport) | SSE, streamable-http, multi-user |
76| [Tools Reference](https://personal-1d37018d.mintlify.app/docs/tools-reference) | All Jira & Confluence tools |
77| [Troubleshooting](https://personal-1d37018d.mintlify.app/docs/troubleshooting) | Common issues & debugging |
78 
79## Compatibility
80 
81| Product | Deployment | Support |
82|---------|------------|---------|
83| Confluence | Cloud | Fully supported |
84| Confluence | Server/Data Center | Supported (v6.0+) |
85| Jira | Cloud | Fully supported |
86| Jira | Server/Data Center | Supported (v8.14+) |
87 
88## Key Tools
89 
90| Jira | Confluence |
91|------|------------|
92| `jira_search` - Search with JQL | `confluence_search` - Search with CQL |
93| `jira_get_issue` - Get issue details | `confluence_get_page` - Get page content |
94| `jira_create_issue` - Create issues | `confluence_create_page` - Create pages |
95| `jira_update_issue` - Update issues | `confluence_update_page` - Update pages |
96| `jira_transition_issue` - Change status | `confluence_add_comment` - Add comments |
97| `jira_get_queue_issues` - Read JSM queue items | |
98| `jira_get_issue_sla` - Calculate SLA metrics | `confluence_get_page_history` - Get historical page versions |
99| `jira_get_issue_development_info` - Get linked PRs, branches, commits | `confluence_get_page_views` - Get page view stats (Cloud only) |
100| `jira_get_issue_proforma_forms` - Get ProForma forms | |
101| `jira_get_proforma_form_details` - Get form details | |
102| `jira_update_proforma_form_answers` - Update form answers | |
103 
104See [Tools Reference](https://personal-1d37018d.mintlify.app/docs/tools-reference) for the complete list.
105 
106## Security
107 
108Never share API tokens. Keep `.env` files secure. See [SECURITY.md](SECURITY.md).
109 
110## Contributing
111 
112See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup.
113 
114## License
115 
116MIT - See [LICENSE](LICENSE). Not an official Atlassian product.
117