atlassian-python-api
Python Atlassian REST API Wrapper
Decision gist · record as of 2026-08-14
Yes. The package has low install friction, active maintenance, no known vulnerabilities, and permissive licensing. It is well-suited for teams already using Atlassian products who need programmatic access. The main gotcha is ensuring you use the correct authentication method (token for Cloud, password for Server) and staying aware of deprecated methods like traditional jql() for Cloud instances.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires network access to an Atlassian instance and valid credentials (username/password or API token for Cloud).
- Low friction installation with a pure-Python wheel and seven runtime dependencies.
- Actively maintained with recent commits and no known vulnerabilities.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows use in commercial and open-source projects with minimal restrictions.
last release 2025-08-21 (358 days) · last repo commit 2026-08-03 · 1,668 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 15,993,384 downloads/mo, #1,167 on PyPI
Alternatives
Verify before relying
pip install atlassian-python-api
from atlassian import Jira
import requests
session = requests.Session()
jira = Jira(
url='http://localhost:8080',
username='admin',
password='admin',
session=session)
data = jira.jql('project = DEMO')
print(data)- Whether all seven runtime dependencies are required for every use case or if some are optional per module.
- Performance characteristics when handling large result sets or batch operations.
- Current test coverage and CI/CD pipeline status beyond the GitHub repository activity.
What it is and what it does
atlassian-python-api is a wrapper around the REST APIs of Atlassian's product suite, letting you automate and integrate with Jira, Confluence, Bitbucket, Bamboo, ServiceDesk, Insight, and Xray from Python code. It abstracts away HTTP details and authentication, exposing product-specific classes (Jira, Confluence, Bitbucket, etc.) with methods for common operations like querying issues, creating pages, or listing projects. The library supports both Atlassian Server and Cloud deployments and can work with optional requests.Session objects for connection pooling.
The package depends on requests for HTTP, oauthlib and requests_oauthlib for OAuth flows, beautifulsoup4 for HTML parsing, jmespath for JSON queries, and typing-extensions for type hints. It is in Beta status, actively maintained, and has been in development since 2015. The description notes that some methods like the traditional jql() are deprecated for Jira Cloud in favor of enhanced_jql() to align with Atlassian's pagination changes.
Use it for
- Automate Jira issue creation, updates, and queries using JQL without writing raw HTTP requests.
- Create and manage Confluence pages and spaces programmatically for documentation workflows.
- Retrieve Bitbucket project and repository data for CI/CD pipeline integration.
- Query Jira Service Desk customer requests and manage tickets in support workflows.
- Access Insight (CMDB) and Xray (test management) data for enterprise asset and test tracking.
- Build custom applications that synchronize data between Atlassian products and external systems.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package has low install friction, active maintenance, no known vulnerabilities, and permissive licensing. It is well-suited for teams already using Atlassian products who need programmatic access. The main gotcha is ensuring you use the correct authentication method (token for Cloud, password for Server) and staying aware of deprecated methods like traditional jql() for Cloud instances.
Install
atlassian-python-api on PyPI
Before you install
Low friction installation with a pure-Python wheel and seven runtime dependencies. Actively maintained with recent commits and no known vulnerabilities.
Requires network access to an Atlassian instance and valid credentials (username/password or API token for Cloud).
License in practice
Apache-2.0 permissive license allows use in commercial and open-source projects with minimal restrictions.
Quickstart
pip install atlassian-python-api
from atlassian import Jira
import requests
session = requests.Session()
jira = Jira(
url='http://localhost:8080',
username='admin',
password='admin',
session=session)
data = jira.jql('project = DEMO')
print(data)Verify before relying
- Whether all seven runtime dependencies are required for every use case or if some are optional per module.
- Performance characteristics when handling large result sets or batch operations.
- Current test coverage and CI/CD pipeline status beyond the GitHub repository activity.
Package facts
| License | Apache-2.0 permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 7 packagesdeprecatedrequestsoauthlibrequests_oauthlibjmespathbeautifulsoup4typing-extensions |
| Maintenance | Actively maintained 358 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 15,993,384 / month, #1,167 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaEnvironment :: ConsoleEnvironment :: Web EnvironmentIntended Audience :: DevelopersIntended Audience :: EducationIntended Audience :: Information TechnologyIntended Audience :: Science/ResearchIntended Audience :: System AdministratorsLicense :: OSI Approved :: Apache Software LicenseNatural Language :: EnglishOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: OS IndependentOperating System :: POSIXOperating System :: UnixProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9Topic :: InternetTopic :: Internet :: WWW/HTTPTopic :: Internet :: WWW/HTTP :: Dynamic ContentTopic :: Software Development :: Libraries :: Application FrameworksTopic :: Software Development :: Libraries :: Python ModulesTopic :: Utilities |
Evidence: atlassian_python_api-4.0.7-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “atlassian rest api wrapper”
- atlassian-python-apiProvides Python bindings to REST APIs for Atlassian products (Jira,…
- jiraA Python library that wraps the Jira REST API, letting you…
- adf-libadf_lib creates and manipulates Atlassian Document Format (ADF)…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also jira · mcp-atlassian · zephyr-python-api · atlasclient · apache-airflow-providers-atlassian-jira · apache-airflow-providers-jira · python-alfresco-api · python-sonarqube-api · atlassian-jwt-auth · dominodatalab