atlassian-mcp

Atlassian MCP Server

An MCP (Model Context Protocol) server that enables Claude and Claude Code to interact with Atlassian Cloud (Confluence and Jira).

Features

Confluence

• Spaces: List, get details, create new spaces
• Pages: Full CRUD (create, read, update, delete)
• Comments: Read and add comments on pages
• Attachments: List and upload attachments
• Search: Query using CQL (Confluence Query Language)

Jira

• Projects: List, get details, create new projects
• Issues: Full CRUD (create, read, update, delete)
• Comments: Read and add comments on issues
• Attachments: List and upload attachments
• Search: Query using JQL (Jira Query Language)

Installation

# Clone or navigate to the project
cd atlassian-mcp

# Create a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install the package
pip install -e .

Configuration

1. Copy the example environment file:

   cp .env.example .env

1. Edit .env with your Atlassian credentials:

   ATLASSIAN_DOMAIN=yourcompany           # yourcompany.atlassian.net
   ATLASSIAN_EMAIL=you@example.com
   ATLASSIAN_API_TOKEN=your_api_token

1. Get your API token from: https://id.atlassian.com/manage-profile/security/api-tokens

Usage

stdio Mode (for Claude Code)

# Run directly
python -m atlassian_mcp --stdio

# Or using the installed command
atlassian-mcp --stdio

SSE Mode (HTTP Server)

# Run the HTTP server
python -m atlassian_mcp --sse

# Server will start on http://127.0.0.1:8000
# SSE endpoint: http://127.0.0.1:8000/sse
# Health check: http://127.0.0.1:8000/health

Claude Code Configuration

Add to your Claude Code settings (~/.claude/settings.json or project-level):

{
  "mcpServers": {
    "atlassian": {
      "command": "/path/to/atlassian-mcp/.venv/bin/python",
      "args": ["-m", "atlassian_mcp", "--stdio"],
      "cwd": "/path/to/atlassian-mcp"
    }
  }
}

The server reads credentials from the .env file in the project directory, so you don't need to specify them in settings.json.

Available Tools

Confluence Tools

| Tool | Description | |------|-------------| | confluence_list_spaces | List all Confluence spaces | | confluence_get_space | Get space details by key | | confluence_create_space | Create a new space | | confluence_list_pages | List pages (optionally by space) | | confluence_get_page | Get page content by ID | | confluence_create_page | Create a new page | | confluence_update_page | Update an existing page | | confluence_delete_page | Delete a page | | confluence_search | Search using CQL | | confluence_get_comments | Get comments on a page | | confluence_add_comment | Add a comment to a page | | confluence_list_attachments | List page attachments | | confluence_upload_attachment | Upload attachment to page |

Jira Tools

| Tool | Description | |------|-------------| | jira_list_projects | List all Jira projects | | jira_get_project | Get project details by key | | jira_create_project | Create a new project | | jira_search_issues | Search using JQL | | jira_get_issue | Get issue details by key | | jira_create_issue | Create a new issue | | jira_update_issue | Update an existing issue | | jira_delete_issue | Delete an issue | | jira_get_comments | Get comments on an issue | | jira_add_comment | Add a comment to an issue | | jira_list_attachments | List issue attachments | | jira_upload_attachment | Upload attachment to issue |

Example Queries

Confluence CQL Examples

type=page AND space=TEAM
text ~ "search term"
creator=currentUser() AND created > now("-7d")
label=important

Jira JQL Examples

project = PROJ
assignee = currentUser() AND status != Done
created >= -7d ORDER BY created DESC
labels = bug AND priority = High

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
ruff format .

# Lint
ruff check .

License

MIT