Integrate Jira and Confluence with AI
An MCP server for Jira and Confluence - search, read, create, and update issues and pages across Cloud or Server/DC.
0.23.0Add to Favorites
Why it matters
Automate your DevOps and Product Management workflows by connecting Jira and Confluence. Leverage AI for enhanced search, content management, and task tracking across both platforms.
Outcomes
What it gets done
Automatically update Jira tasks from meeting notes.
Perform AI-powered searches and summarizations within Confluence.
Filter Jira tasks intelligently by project and date.
Generate and manage technical documentation.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-atlassian | bash Capabilities
Tools your agent gets
Search Confluence pages and content with AI-powered summarization capabilities.
Retrieve and read specific Confluence pages by title or ID.
Create new Confluence pages with formatted content and metadata.
Update existing Confluence pages with new content and revisions.
Search Jira issues with filtering by project, date, and status.
Retrieve detailed information about a specific Jira issue.
Create new Jira issues with specified fields and project assignment.
Update Jira issue fields, status, and assignee information.
Overview
Atlassian MCP Server
This MCP server exposes 72 tools for Jira and Confluence: issue and page search, read, create, update, transition, and comment, across Cloud and Server/Data Center deployments. Use it when an AI assistant needs to search, read, create, or update Jira issues or Confluence pages. Server/Data Center requires v6.0+/v8.14+ and a Personal Access Token.
What it does
An MCP server for Atlassian products - Jira and Confluence - supporting both Cloud and Server/Data Center deployments, with 72 tools total. Key Jira tools include jira_search (search with JQL), jira_get_issue (get issue details), jira_create_issue, jira_update_issue, and jira_transition_issue (change status). Key Confluence tools include confluence_search (search with CQL), confluence_get_page, confluence_create_page, confluence_update_page, and confluence_add_comment. This lets an AI assistant find issues assigned to a user in a specific project, search Confluence for documentation, create a bug ticket, or update an issue's status conversationally, across the full 72-tool surface documented in the project's Tools Reference.
When to use - and when NOT to
Use it when an AI assistant needs to search, read, create, or update Jira issues or Confluence pages - triaging assigned work, looking up documentation, filing bugs, or transitioning issue status. Confluence Cloud and Jira Cloud are fully supported; Confluence Server/Data Center is supported from v6.0+ and Jira Server/Data Center from v8.14+, using a Personal Access Token (JIRA_PERSONAL_TOKEN) instead of a username plus API token for those on-premises deployments.
Inputs and outputs
Input is a natural-language request (a JQL/CQL-style search, an issue key, or the fields for a new issue or page). Output is matching issues or pages, a created/updated issue or page confirmation, or a structured error when a request fails - the project ships a dedicated Troubleshooting doc page covering common issues and debugging steps for exactly these failure cases.
How to install
{
"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"
}
}
}
}
Installable via uvx with no separate clone step, or via Docker, pip, or from source for teams that prefer a pinned local build. Get an API token from id.atlassian.com's security settings (Cloud) or use a Personal Access Token (Server/Data Center). Full documentation, including an llms.txt-format sitemap and complete documentation file for LLM consumption, is published at mcp-atlassian.soomiles.com, alongside dedicated pages on HTTP transport options (SSE, streamable-http, multi-user) for teams running it as a shared service rather than a per-user local process.
Who it's for
Teams using Jira and/or Confluence who want an AI assistant to search, read, create, and update issues and pages conversationally across either Atlassian Cloud or an on-premises Server/Data Center deployment, without constantly switching between the separate Jira and Confluence web interfaces to look things up. API tokens and .env files should never be shared and should be kept secure, per the project's own security guidance. Distributed under the MIT License; not an official Atlassian product.
Source README
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
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:
{
"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_TOKENinstead ofJIRA_USERNAME+JIRA_API_TOKEN. See Authentication for details.
Autohand Code
Use the same uvx server with your Atlassian credentials:
autohand mcp add 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 \
uvx mcp-atlassian
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 sitemapllms-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 |
jira_update_issue - Update issues |
confluence_update_page - Update pages |
jira_transition_issue - Change status |
confluence_add_comment - Add comments |
98 tools total - See Tools Reference for the complete list.
Security
Never share API tokens. Keep .env files secure. See SECURITY.md.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.