mcp-atlassian 0.16.0

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.16.0

MCP Atlassian

PyPI Version PyPI - Downloads PePy - Total Downloads License

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

Confluence Demo

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

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_TOKEN instead of JIRA_USERNAME + JIRA_API_TOKEN. See 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 personal-1d37018d.mintlify.app.

Documentation is also available in llms.txt format, which LLMs can consume easily:

llms.txt — documentation sitemap
llms-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
`jira_get_issue_sla` - Calculate SLA metrics	`confluence_get_page_history` - Get historical page versions
`jira_get_issue_development_info` - Get linked PRs, branches, commits	`confluence_get_page_views` - Get page view stats (Cloud only)
`jira_get_issue_proforma_forms` - Get ProForma forms
`jira_get_proforma_form_details` - Get form details
`jira_update_proforma_form_answers` - Update form answers

See Tools Reference for the complete list.

Security

Never share API tokens. Keep .env files secure. See SECURITY.md.

Contributing

See CONTRIBUTING.md for development setup.

License

MIT - See LICENSE. Not an official Atlassian product.

Metadata

Release files for mcp-atlassian 0.16.0

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.16.0
File	Size	Uploaded
mcp_atlassian-0.16.0.tar.gz	588.0 kB	Feb 21, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-atlassian 0.16.0
File	Interpreter	ABI	Platform	Reset
mcp_atlassian-0.16.0-py3-none-any.whl 243.0 kB Feb 21, 2026	Python 3	none	any	Details

Total release size: 831.0 kB

Release files / mcp_atlassian-0.16.0.tar.gz

Download URL	mcp_atlassian-0.16.0.tar.gz
Size	588.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`07fdf178c45bdc4bd5a21aa1679d1dbf8ce4a59de3e60f2a6b68bf6d50734138`
BLAKE2b-256 checksum How to use checksums	`556b8407c33ce8731a3a5ed0137818f23aa9c5178aa94e75d4a83ccc9a04b966`
Upload date	Feb 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

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

Download URL	mcp_atlassian-0.16.0-py3-none-any.whl
Size	243.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`944dd814807bc655ce5bca03be6a09d181d9d1040fc49f9286c1c44a54f78678`
BLAKE2b-256 checksum How to use checksums	`4d4978a0918af32cdf60f1c250a9d938e0f08eacc1f8d574e6b13c4e7216f819`
Upload date	Feb 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`