mcp-atlassian 0.17.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.17.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_queue_issues` - Read JSM queue items
`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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_atlassian-0.17.0.tar.gz (641.8 kB view details)

Uploaded Feb 24, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mcp_atlassian-0.17.0-py3-none-any.whl (254.2 kB view details)

Uploaded Feb 24, 2026 Python 3

File details

Details for the file mcp_atlassian-0.17.0.tar.gz.

File metadata

Download URL: mcp_atlassian-0.17.0.tar.gz
Upload date: Feb 24, 2026
Size: 641.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.10.5 {"installer":{"name":"uv","version":"0.10.5","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}

File hashes

Hashes for mcp_atlassian-0.17.0.tar.gz
Algorithm	Hash digest
SHA256	`d4ee09e691a0bd212d64193d83389c628ae6347075706de0a22ce6a2307f7fed`
MD5	`702ba5cf105f411b70640584528c0841`
BLAKE2b-256	`5f0143affc74fb7e89616642b2f2de4754edd8a61f183c5fca1ac49a3c770eb2`

See more details on using hashes here.

File details

Details for the file mcp_atlassian-0.17.0-py3-none-any.whl.

File metadata

Download URL: mcp_atlassian-0.17.0-py3-none-any.whl
Upload date: Feb 24, 2026
Size: 254.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.10.5 {"installer":{"name":"uv","version":"0.10.5","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}

File hashes

Hashes for mcp_atlassian-0.17.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`7939fb95fd6998dd8b9d885fcecbbbd7aad6c12af6eacd13b32137abcb3466bb`
MD5	`0972cbde957bad000cb24d0cd5e1885c`
BLAKE2b-256	`03fd28b8d103a00785a0288917ebf4e213bf1575b5e5f8e425d999d360482bd7`