mcp-atlassian 0.1.7

The Model Context Protocol (MCP) Atlassian integration is an open-source implementation that bridges Atlassian products (Jira and Confluence) with AI language models following Anthropic's MCP specification. This project enables secure, contextual AI interactions with Atlassian tools while maintaining data privacy and security. Key features include:

pip install mcp-atlassian==0.1.7

MCP Atlassian

Model Context Protocol (MCP) server for Atlassian Cloud products (Confluence and Jira). This integration is designed specifically for Atlassian Cloud instances and does not support Atlassian Server or Data Center deployments.

Feature Demo

Demo

Features

Search and read Confluence spaces/pages
Get Confluence page comments
Search and read Jira issues
Get project issues and metadata

API

Resources

confluence://{space_key}: Access Confluence spaces and pages
confluence://{space_key}/pages/{title}: Access specific Confluence pages
jira://{project_key}: Access Jira project and its issues
jira://{project_key}/issues/{issue_key}: Access specific Jira issues

Tools

Confluence Tools

confluence_search
- Search Confluence content using CQL
- Inputs:
  - query (string): CQL query string
  - limit (number, optional): Results limit (1-50, default: 10)
- Returns:
  - Array of search results with page_id, title, space, url, last_modified, type, and excerpt
confluence_get_page
- Get content of a specific Confluence page
- Inputs:
  - page_id (string): Confluence page ID
  - include_metadata (boolean, optional): Include page metadata (default: true)
confluence_get_comments
- Get comments for a specific Confluence page
- Input: page_id (string)

Jira Tools

jira_get_issue
- Get details of a specific Jira issue
- Inputs:
  - issue_key (string): Jira issue key (e.g., 'PROJ-123')
  - expand (string, optional): Fields to expand
jira_search
- Search Jira issues using JQL
- Inputs:
  - jql (string): JQL query string
  - fields (string, optional): Comma-separated fields (default: "*all")
  - limit (number, optional): Results limit (1-50, default: 10)
jira_get_project_issues
- Get all issues for a specific Jira project
- Inputs:
  - project_key (string): Project key
  - limit (number, optional): Results limit (1-50, default: 10)

Usage with Claude Desktop

Get API tokens from: https://id.atlassian.com/manage-profile/security/api-tokens
Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@domain.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your.email@domain.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Alternative configuration using uv

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-atlassian",
        "run",
        "mcp-atlassian"
      ],
      "env": {
        "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@domain.com",
        "CONFLUENCE_API_TOKEN": "your_api_token",
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your.email@domain.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Replace /path/to/mcp-atlassian with the actual path where you've cloned the repository.

Security

Never share API tokens
Keep .env files secure and private
See SECURITY.md for best practices

License

Licensed under MIT - see LICENSE file. This is not an official Atlassian product.

Metadata

Release files for mcp-atlassian 0.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-atlassian 0.1.7
File	Size	Uploaded
mcp_atlassian-0.1.7.tar.gz	34.4 kB	Dec 20, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-atlassian 0.1.7
File	Interpreter	ABI	Platform	Reset
mcp_atlassian-0.1.7-py3-none-any.whl 12.8 kB Dec 20, 2024	Python 3	none	any	Details

Total release size: 47.2 kB

Release files / mcp_atlassian-0.1.7.tar.gz

Download URL	mcp_atlassian-0.1.7.tar.gz
Size	34.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`958f8b56c8a48b1583b67a6ff8e7bd191f69e0c072f11d780e075221072b4d0b`
BLAKE2b-256 checksum How to use checksums	`890c0b546b123cac2933790425906058ce9de4e4105104a4638d55cf91afa6eb`
Upload date	Dec 20, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.5.5`

Release files / mcp_atlassian-0.1.7-py3-none-any.whl

Download URL	mcp_atlassian-0.1.7-py3-none-any.whl
Size	12.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`173fa71d47bed27e92460f0a627311ea7ec62dfd58858993bc0e165e73a19ac8`
BLAKE2b-256 checksum How to use checksums	`0d947da3ca3bee2e87e3efd2c768c4ac33d2e91efff020f131b1ad18b1fc894b`
Upload date	Dec 20, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.5.5`