Skip to main content

MCP Atlassian

PyPI Version PyPI - Downloads PePy - Total Downloads Run Tests License Docs

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, Cursor, or GitHub Copilot 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.

Autohand Code

Use the same uvx server with your Atlassian credentials:

autohand mcp add 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 \
  uvx mcp-atlassian

Add --scope project after add to keep the configuration in the current project. See Autohand Code for current installation and CLI 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 mcp-atlassian.soomiles.com.

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

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

98 tools total — 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.24.6

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.24.6
File Size Uploaded Provenance Actions
mcp_atlassian-0.24.6.tar.gz 1.3 MB Without provenance Details for mcp_atlassian-0.24.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-atlassian 0.24.6
File Interpreter ABI Platform Actions
mcp_atlassian-0.24.6-py3-none-any.whl Python 3 none any Details for mcp_atlassian-0.24.6-py3-none-any.whl

Total release size: 1.7 MB

Release files / mcp_atlassian-0.24.6.tar.gz

Download URL mcp_atlassian-0.24.6.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
1ca13866e7d3a6b6357ed8b146617a5ffd848078862efad9965c165b484c8be7
BLAKE2b-256 checksum
How to use checksums
5b01fdf2776b4132d2c1b0976da09bbf3f1d46617038a3cc42a0db58abfd7bcb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.24.6-py3-none-any.whl

Download URL mcp_atlassian-0.24.6-py3-none-any.whl
Size 481.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d515b53b7b3f330c94ac6b675bcf2bdd244deb725f5db575575627dfe0786070
BLAKE2b-256 checksum
How to use checksums
69ec3af03eea48868ac48bc34e57e590693baf34a9323e1c860f0af8d60293fe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for mcp-atlassian 0.24.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.24.6 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page