This MCP server enables LLM agents to interact with Atlassian Jira and Confluence Cloud through comprehensive tools for managing issues, pages, and content.
Jira Capabilities:
Search & List Issues: Use JQL queries to find and list issues with customizable result limits
Issue Management: View full issue details, create new issues with project/type specifications, and update issue summaries/descriptions
Comments: Add comments (supports plain text or Atlassian Document Format) and retrieve existing comments
Workflow: Transition issues between statuses using transition IDs and discover available transitions for specific issues
Attachments: Download files attached to Jira issues
Confluence Capabilities:
Page Management: List pages within spaces, view page content/metadata, create new pages (optionally nested under parent pages), and delete pages
Content Editing: Update page content with automatic version handling and support for Mermaid diagrams via code blocks
Search: Perform advanced searches using CQL with customizable result limits and criteria like labels and titles
Comments: Retrieve all comments on Confluence pages
Special Features:
Supports Atlassian Document Format (ADF) for rich text in Jira descriptions and comments
Automatic version management for Confluence page updates with manual control option
Provides tools for interacting with Atlassian Cloud services, including Jira issue management (search, create, update, comment, transition) and Confluence page management (search, view, create, edit, delete).
Allows searching and listing pages within spaces, viewing page content, creating new pages (including nested pages), editing pages with auto-versioning, and deleting pages using CQL search capabilities.
Enables searching issues with JQL, viewing issue details, creating and updating issues with rich text support, adding comments, and transitioning issues through workflows.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@atlassian-mcp-serverlist Jira issues assigned to me that are overdue"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Atlassian MCP Server
An MCP server for Jira and Confluence Cloud. Write in markdown — the server converts to Atlassian Document Format (ADF) automatically.
Quickstart
git clone https://github.com/tingyiy/atlassian-mcp-server.git
cd atlassian-mcp-server
pip install -r requirements.txt # or: uv pip install -r requirements.txtThen add it to your MCP client (see Configuration below).
You'll need an Atlassian API token and these values:
Variable | Example |
|
|
| your API token |
|
|
|
|
|
|
Related MCP server: Jira
Tools
Jira
Tool | Description |
| Search issues using JQL |
| Get full issue details |
| Create an issue (markdown description) |
| Update summary or description (markdown) |
| Add a comment (markdown) |
| Retrieve all comments |
| Download an attachment by ID |
| Move issue through workflow |
| List available transitions |
Confluence
Tool | Description |
| List pages in a space |
| Get page content and metadata |
| Create a page (optionally nested) |
| Update a page (auto-increments version) |
| Delete a page |
| Search using CQL |
| Get all comments on a page |
| Add a comment (with reply support) |
| Download an image attachment |
Markdown Support
Jira tools (jira_create_issue, jira_update_issue, jira_add_comment) accept markdown for descriptions and comments. The server converts it to ADF behind the scenes using md2adf.
Supported formatting: headings, bold, italic, strikethrough, inline code, links, images, code blocks (with language), bullet/ordered/nested lists, blockquotes, horizontal rules, and tables.
Configuration
Claude Code
Add to ~/.claude.json:
{
"mcpServers": {
"atlassian": {
"type": "stdio",
"command": "python3",
"args": ["/path/to/atlassian-mcp-server/server.py"],
"env": {
"ATLASSIAN_USERNAME": "you@company.com",
"ATLASSIAN_API_KEY": "your_api_token",
"JIRA_URL": "https://your-domain.atlassian.net/rest/api/3",
"CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
"CONFLUENCE_SPACE_KEY": "ENG"
}
}
}
}Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"atlassian": {
"command": "python3",
"args": ["/path/to/atlassian-mcp-server/server.py"],
"env": {
"ATLASSIAN_USERNAME": "you@company.com",
"ATLASSIAN_API_KEY": "your_api_token",
"JIRA_URL": "https://your-domain.atlassian.net/rest/api/3",
"CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
"CONFLUENCE_SPACE_KEY": "ENG"
}
}
}
}Cursor / VS Code
Add to .cursor/mcp.json or .vscode/mcp.json:
{
"mcpServers": {
"atlassian": {
"command": "python3",
"args": ["/path/to/atlassian-mcp-server/server.py"],
"env": {
"ATLASSIAN_USERNAME": "you@company.com",
"ATLASSIAN_API_KEY": "your_api_token",
"JIRA_URL": "https://your-domain.atlassian.net/rest/api/3",
"CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki"
}
}
}
}Make sure the python3 in command points to an environment with the dependencies installed. To be explicit, use the full path (e.g. /path/to/venv/bin/python).
Notes
Mermaid Diagrams in Confluence
Confluence's Mermaid plugin stores diagram source internally, so the MCP tools can't render them programmatically. Instead, provide the Mermaid source in a code block — the user can then convert it in the Confluence editor.
License
MIT — see LICENSE.