MCP server for Atlassian tools (Confluence, Jira)
MCP Atlassian is a Model Context Protocol server that connects Claude Desktop and other MCP-compatible AI clients to both Confluence and Jira, covering Cloud, Server, and Data Center deployments. It exposes 72 tools in total, including `jira_search` (JQL-based), `jira_create_issue`, `jira_transition_issue`, `confluence_search` (CQL-based), `confluence_create_page`, and `confluence_update_page`, giving an AI assistant read and write access across both platforms. Authentication supports API tokens, Personal Access Tokens, and OAuth 2.0, and the server can be run via uvx, Docker, or pip. A notable detail is that the documentation is also published in llms.txt format, making it directly consumable by language models. The project targets developers, project managers, and teams who want to query issues, manage tickets, search knowledge bases, and create or update documentation without leaving their AI assistant interface.
- ✓Open-source license (MIT)
- ✓Recently active
- ✓Healthy fork ratio
- ✓Clear description
- ✓Topics declared
- ✓Mature repo (>1y old)
claude mcp add mcp-atlassian -- uvx mcp-atlassian{
"mcpServers": {
"mcp-atlassian": {
"command": "uvx",
"args": ["mcp-atlassian"]
}
}
}MCP Servers overview
# MCP Atlassian
[](https://github.com/sooperset/mcp-atlassian/actions/workflows/tests.yml)
[](https://mcp-atlassian.soomiles.com)
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
<details>
<summary>Confluence Demo</summary>
https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785
</details>
## 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](https://mcp-atlassian.soomiles.com/docs/authentication).
### 2. Configure Your IDE
Add to your Claude Desktop or Cursor MCP configuration:
```json
{
"mcpServers": {
"mcp-atlassian": {
"command": "uvx",
"args": ["mcp-atlassian"],
"env": {
"JIRA_URL": "https://your-company.atlassian.net",
"JIRA_USERNAME": "your.email@company.com",
"JIRA_API_TOKEN": "your_api_token",
"CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
"CONFLUENCE_USERNAME": "your.email@company.com",
"CONFLUENCE_API_TOKEN": "your_api_token"
}
}
}
}
```
> **Server/Data Center users**: Use `JIRA_PERSONAL_TOKEN` instead of `JIRA_USERNAME` + `JIRA_API_TOKEN`. See [Authentication](https://mcp-atlassian.soomiles.com/docs/authentication) for 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](https://mcp-atlassian.soomiles.com)**.
Documentation is also available in [llms.txt format](https://llmstxt.org/), which LLMs can consume easily:
- [`llms.txt`](https://mcp-atlassian.soomiles.com/llms.txt) — documentation sitemap
- [`llms-full.txt`](https://mcp-atlassian.soomiles.com/llms-full.txt) — complete documentation
| Topic | Description |
|-------|-------------|
| [Installation](https://mcp-atlassian.soomiles.com/docs/installation) | uvx, Docker, pip, from source |
| [Authentication](https://mcp-atlassian.soomiles.com/docs/authentication) | API tokens, PAT, OAuth 2.0 |
| [Configuration](https://mcp-atlassian.soomiles.com/docs/configuration) | IDE setup, environment variables |
| [HTTP Transport](https://mcp-atlassian.soomiles.com/docs/http-transport) | SSE, streamable-http, multi-user |
| [Tools Reference](https://mcp-atlassian.soomiles.com/docs/tools-reference) | All Jira & Confluence tools |
| [Troubleshooting](https://mcp-atlassian.soomiles.com/docs/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 |
| `jira_update_issue` - Update issues | `confluence_update_page` - Update pages |
| `jira_transition_issue` - Change status | `confluence_add_comment` - Add comments |
**72 tools total** — See [Tools Reference](https://mcp-atlassian.soomiles.com/docs/tools-reference) for the complete list.
## Security
Never share API tokens. Keep `.env` files secure. See [SECURITY.md](SECURITY.md).
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup.
## License
MIT - See [LICENSE](LICENSE). Not an official Atlassian product.
What people ask about mcp-atlassian
What is sooperset/mcp-atlassian?
+
sooperset/mcp-atlassian is mcp servers for the Claude AI ecosystem. MCP server for Atlassian tools (Confluence, Jira) It has 5.4k GitHub stars and was last updated 2mo ago.
How do I install mcp-atlassian?
+
You can install mcp-atlassian by cloning the repository (https://github.com/sooperset/mcp-atlassian) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.
Is sooperset/mcp-atlassian safe to use?
+
Our security agent has analyzed sooperset/mcp-atlassian and assigned a Trust Score of 100/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.
Who maintains sooperset/mcp-atlassian?
+
sooperset/mcp-atlassian is maintained by sooperset. The last recorded GitHub activity is from 2mo ago, with 337 open issues.
Are there alternatives to mcp-atlassian?
+
Yes. On ClaudeWave you can browse similar mcp servers at /categories/mcp, sorted by popularity or recent activity.
Deploy mcp-atlassian to your cloud
Ship this repo to production in minutes. Each platform spins up its own environment with editable env vars.
Maintain this repo? Add a badge to your README
Drop the badge into your GitHub README to show it's tracked on ClaudeWave. Each badge links back to this page and reflects the live Trust Score.
[](https://claudewave.com/repo/sooperset-mcp-atlassian)<a href="https://claudewave.com/repo/sooperset-mcp-atlassian"><img src="https://claudewave.com/api/badge/sooperset-mcp-atlassian" alt="Featured on ClaudeWave: sooperset/mcp-atlassian" width="320" height="64" /></a>More MCP Servers
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
An open-source AI agent that brings the power of Gemini directly into your terminal.
The fastest path to AI-powered full stack observability, even for lean teams.
🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
⭐AI-driven public opinion & trend monitor with multi-platform aggregation, RSS, and smart alerts.🎯 告别信息过载，你的 AI 舆情监控助手与热点筛选工具！聚合多平台热点 + RSS 订阅，支持关键词精准筛选。AI 智能筛选新闻 + AI 翻译 + AI 分析简报直推手机，也支持接入 MCP 架构，赋能 AI 自然语言对话分析、情感洞察与趋势预测等。支持 Docker ，数据本地/云端自持。集成微信/飞书/钉钉/Telegram/邮件/ntfy/bark/slack 等渠道智能推送。